Casa Mazatlán — Aplicación Laravel

Proyecto de ejemplo para gestionar clientes y créditos.

Descripción

Aplicación Laravel (desarrollada para uso local) que permite crear, editar y listar clientes y creditos. Este repositorio está configurado para PHP 8.2 y Laravel 12.x.

Requisitos (desarrollo)

• PHP 8.2 (CLI y módulo Apache si usas XAMPP)
• Composer
• Microsoft SQL Server (o instancia accesible)
• Extensiones PHP sqlsrv y pdo_sqlsrv para PHP 8.2 (Windows/XAMPP)
• Node.js + npm (para assets / Vite)

Instalar extensiones SQL Server para PHP 8.2 (Windows / XAMPP)

Sigue estos pasos para habilitar sqlsrv y pdo_sqlsrv con PHP 8.2 (Thread Safe, x64) en XAMPP:

1. Verifica la versión exacta de PHP usada por Apache. Puedes crear un archivo phpinfo.php en public con <?php phpinfo(); o ejecutar php -v en la consola para comprobar la versión y si es TS (Thread Safe) o NTS.

2. Descarga los drivers oficiales Microsoft Drivers for PHP for SQL Server: https://learn.microsoft.com/sql/connect/php/download-drivers-php-sql-server?view=sql-server-ver16

   Descarga las DLLs compatibles con PHP 8.2 TS x64, por ejemplo:

   • php_sqlsrv_82_ts_x64.dll
   • php_pdo_sqlsrv_82_ts_x64.dll

3. Copia las DLLs descargadas a la carpeta de extensiones de PHP de XAMPP, por ejemplo C:\xampp\php\ext.

4. Edita el php.ini que usa Apache (p. ej. C:\xampp\php\php.ini) y añade las líneas:

   extension=php_sqlsrv_82_ts_x64.dll
   extension=php_pdo_sqlsrv_82_ts_x64.dll

   Si las DLLs tienen otros nombres, puedes usar extension=php_sqlsrv.dll / extension=php_pdo_sqlsrv.dll siempre que apunten a los archivos correctos.

5. Reinicia Apache desde el panel de control de XAMPP.

6. Verifica con phpinfo() o php -m que aparecen sqlsrv y pdo_sqlsrv en los módulos cargados.

Habilitar TCP/IP y puerto 1433 en SQL Server

1. Abre SQL Server Configuration Manager.
2. Ve a SQL Server Network Configuration → Protocols for <INSTANCE> y habilita TCP/IP.
3. En las propiedades de TCP/IP (pestaña IP Addresses) revisa IPAll y asegúrate de que TCP Port esté configurado en 1433 (o el puerto que uses).
4. Reinicia el servicio de SQL Server.
5. Abre el Firewall de Windows y crea una regla de entrada para permitir TCP en el puerto 1433 (o el puerto que uses) para el servicio de SQL Server.

Configurar .env

Copia .env.example a .env y edita la sección de base de datos:

DB_CONNECTION=sqlsrv
DB_HOST=127.0.0.1
DB_PORT=1433
DB_DATABASE=nombre_bd
DB_USERNAME=usuario
DB_PASSWORD=secreto

Migrar y sembrar la base de datos

Instala dependencias, genera la key, migra y siembra:

composer install
php artisan key:generate
php artisan migrate --seed

Si prefieres usar SQLite para pruebas locales, el proyecto contiene database/database.sqlite como alternativa.

Uso y pruebas locales

• Ejecuta php artisan serve y abre http://localhost:8000.
• O usa XAMPP y configura un VirtualHost apuntando a la carpeta public.

---

Si quieres, puedo añadir capturas de pantalla, instrucciones paso a paso para descargar las DLLs desde la página de Microsoft o una versión en inglés del README.

Rutas del proyecto

Listado simple de las rutas públicas definidas en routes/web.php:

• GET / → vista welcome

Rutas para Clientes (prefijo /clientes):

• GET /clientes → ClientesController@index (nombre: clientes.index)
• GET /clientes/add → vista clientes.create (nombre: clientes.create)
• POST /clientes → ClientesController@store (nombre: clientes.store)
• GET /clientes/{id}/edit → ClientesController@edit (nombre: clientes.edit)
• PUT /clientes/{id} → ClientesController@update (nombre: clientes.update)
• DELETE /clientes/{id} → ClientesController@destroy (nombre: clientes.destroy)

Rutas para Créditos (prefijo /creditos):

• GET /creditos → CreditosController@index (nombre: creditos.index)
• GET /creditos/create → CreditosController@create (nombre: creditos.create)
• POST /creditos → CreditosController@store (nombre: creditos.store)
• GET /creditos/{id} → CreditosController@show (nombre: creditos.show)
• GET /creditos/{id}/edit → CreditosController@edit (nombre: creditos.edit)
• PUT /creditos/{id} → CreditosController@update (nombre: creditos.update)
• DELETE /creditos/{id} → CreditosController@destroy (nombre: creditos.destroy)

Si quieres, puedo añadir ejemplos de curl o Postman para probar las rutas.