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.