windows clonar desde github i configurar projecte local amb github desktop

GitHub és una plataforma per gestionar, compartir i col·laborar en projectes de programació. Permet emmagatzemar codi en línia, fer seguiment de canvis amb Git, i treballar en equip de manera organitzada. També facilita la integració de codi amb eines de desenvolupament i desplegament.

Despres de clonar amb cmd fer....

composer install
composer update
npm install
npm run build
npm audit fix
cp .env.example .env
php artisan key:generate
php artisan migrate
php artisan storage:link

1. Clonar el repositori:

• Obre GitHub Desktop.
  Fes clic a "File" > "Clone repository..." o al botó "+" i selecciona "Clone repository...".
• Insereix la URL del repositori.
  Pega l'enllaç (per exemple: https://github.com/usuari/projecte.git) i tria una carpeta local on clonar-lo.
• Clona el repositori.
  GitHub Desktop descarregarà el codi a la carpeta seleccionada.

2. Configuració del projecte:

1. composer install:
   Instal·la totes les dependències de PHP definides al fitxer composer.json. Aquest pas és essencial per Laravel i CodeIgniter.
2. npm install:
   Instal·la les dependències front-end definides al fitxer package.json. Aquestes solen incloure TailwindCSS, Laravel Mix o altres eines front-end.
3. npm run build:
   Compila i minifica els fitxers CSS i JavaScript, preparant-los per a la producció.
4. cp .env.example .env:
   Crea el fitxer .env a partir del model .env.example. Aquest fitxer conté la configuració del projecte (base de dades, clau d'aplicació, etc.).
5. php artisan key:generate:
   Genera una clau única per assegurar el xifrat de dades i altres funcionalitats de Laravel. Aquesta clau s'afegirà al .env.
6. php artisan migrate:
   Crea les taules de la base de dades segons les migracions definides al projecte.

3. Executar el projecte:

• Laravel: Llença un servidor local amb php artisan serve. Obre l'URL indicada (normalment http://127.0.0.1:8000).
• CodeIgniter: Configura el .env o el fitxer app/Config/App.php i obre l'URL corresponent.

1. Com funciona php artisan serve:

Aquest és un comandament utilitzat en Laravel per iniciar un servidor web local ràpidament sense haver de configurar un servidor com Apache o Nginx.

• Què fa?
  • Llença un servidor web integrat basat en PHP (PHP Built-in Server).
  • Normalment, escolta a http://127.0.0.1:8000 (localhost).
  • Permet que el teu projecte Laravel sigui accessible al navegador per fer proves durant el desenvolupament.
• Com utilitzar-lo?
  Des de la línia de comandaments, dins la carpeta del projecte Laravel, executa:

• php artisan serve

• Això iniciarà el servidor i mostrarà una URL com aquesta:

• Starting Laravel development server: http://127.0.0.1:8000
  [Sat Dec 16 12:34:56 2024] PHP 8.2.12 Development Server (http://127.0.0.1:8000) started
  
  

• Pots visitar l'URL per veure la teva aplicació Laravel.
• Limitacions:
  • Aquest servidor és només per desenvolupament. No és adequat per entorns de producció.
  • Si tens un altre procés utilitzant el port 8000, pots especificar un port diferent:

  • php artisan serve --port=8080

2. Configuració d’un servidor virtual amb Apache:

Si prefereixes utilitzar Apache (via XAMPP) per un entorn més estable o per imitar un servidor real, segueix aquests passos:

2.1 Editar httpd-vhosts.conf:

• Obre el fitxer:
  C:\xampp\apache\conf\extra\httpd-vhosts.conf.
• Afegeix una configuració per al teu projecte Laravel:

• <VirtualHost *:80>
      DocumentRoot "C:/xampp/htdocs/nom_del_projecte/public"
      ServerName nomdelprojecte.local
      <Directory "C:/xampp/htdocs/nom_del_projecte/public">
          Options Indexes FollowSymLinks
          AllowOverride All
          Require all granted
      </Directory>
  </VirtualHost>
  
  

• Explicació:
  • DocumentRoot: Ruta on es troba la carpeta public de Laravel.
  • ServerName: El domini virtual que vols utilitzar (per exemple, nomdelprojecte.local).
  • <Directory>: Permet que Apache serveixi correctament el contingut del directori.

2.2 Editar el fitxer hosts:

• Obre el fitxer:
  C:\Windows\System32\drivers\etc\hosts com administrador.
• Afegeix aquesta línia al final del fitxer:

• 127.0.0.1    nomdelprojecte.local

• Explicació:
  • 127.0.0.1 és l’adreça IP de localhost.
  • nomdelprojecte.local és el domini virtual que has definit a httpd-vhosts.conf.

2.3 Reiniciar Apache:

• Obre el panell de control de XAMPP.
• Atura i torna a iniciar el servei Apache.

2.4 Accedir al projecte:

• Ara pots accedir al teu projecte al navegador visitant http://nomdelprojecte.local.

Comparativa entre php artisan serve i el servidor virtual Apache:

Característicaphp artisan serveServidor Virtual ApacheFacilitat de configuració | Molt fàcil, només cal executar el comandament. | Requereix editar fitxers i reiniciar Apache.
Fiabilitat | Només per desenvolupament. | Apte per desenvolupament i producció local.
Flexibilitat | Port configurable (però un sol projecte). | Permet múltiples projectes amb diferents dominis.
Velocitat d'inici | Instantània. | Més lenta per la configuració inicial.

Per al desenvolupament ràpid, php artisan serve és ideal. Per entorns més realistes o per treballar amb múltiples projectes, el servidor virtual Apache és més adequat.