Instal·lació

Requisits del sistema#

Abans d'instal·lar Laravel, necessites tenir PHP 8.2 o superior i Composer, el gestor de dependències estàndard de PHP. També cal que tinguis habilitades les extensions PHP següents: OpenSSL, PDO, Mbstring, Tokenizer, XML, Ctype, JSON i BCMath. La majoria d'instal·lacions de PHP ja inclouen aquestes extensions per defecte.

Instal·lació amb Composer#

La manera més directa de crear un projecte Laravel és amb la comanda create-project de Composer:

composer create-project laravel/laravel el-meu-projecte

Això crearà un directori el-meu-projecte amb una instal·lació fresca de Laravel, totes les dependències descarregades i un fitxer .env configurat amb valors per defecte.

Un cop creat el projecte, pots arrencar el servidor de desenvolupament integrat:

cd el-meu-projecte
php artisan serve

Obre el navegador a http://localhost:8000 i veuràs la pàgina de benvinguda de Laravel. Si la veus, tot funciona correctament.

Laravel Installer#

Si treballes sovint amb Laravel, l'instal·lador global és una opció més còmoda. Primer instal·la'l amb Composer:

composer global require laravel/installer

Després, crear un projecte nou és tan senzill com:

laravel new el-meu-projecte

L'instal·lador et farà algunes preguntes interactives sobre la configuració del projecte: quin starter kit vols, quin framework de testing prefereixes, quina base de dades utilitzaràs, entre altres. Això et permet tenir un projecte configurat al teu gust des del primer moment.

Laravel Herd#

Laravel Herd és l'opció més còmoda per a desenvolupament local. Disponible per a macOS i Windows, proporciona PHP, Nginx i altres eines sense necessitat de configuració manual. Simplement instal·la Herd i ja tens tot el que necessites.

# Amb Herd instal·lat, crear un projecte és immediat
cd ~/Herd
laravel new el-meu-projecte

Un dels avantatges de Herd és que configura automàticament un domini local .test per a cada projecte. Això vol dir que el teu projecte serà accessible a http://el-meu-projecte.test sense haver de tocar cap configuració de servidor.

Verificar la instal·lació#

Un cop instal·lat el projecte, pots verificar que tot està en ordre amb un parell de comandes:

php artisan --version
# Laravel Framework 11.x.x
 
php artisan about
# Mostra informació detallada del projecte: versió de PHP,
# base de dades configurada, drivers de cache, etc.

La comanda php artisan about és especialment útil perquè et dóna una visió general de com està configurat el projecte en un sol cop d'ull.