Instalación

Requisitos del servidor

Laravel Framework tiene algunos requisitos del sistema. Por supuesto, todos estos requisitos son cumplidos por la máquina virtual Laravel Homestead, por lo que es altamente recomendado que usted use Homestead como su entorno de desarrollo local Laravel.

Sin embargo, si no está usando Homestead, necesitará asegurarse de que su servidor cumpla con los siguientes requisitos:

• PHP > = 7.0.0
• OpenSSL PHP Extension
• XML PHP Extension
• PDO PHP Extension
• Tokenizer PHP Extension
• Mbstring PHP Extension

Instalación de Laravel

Laravel utiliza Composer para gestionar sus dependencias. Por lo tanto, antes de usar Laravel, asegúrese de tener instalado Composer en su máquina.

A través del Instalador de Laravel

Primero, descargue el instalador de Laravel usando Composer:

composer global require "laravel/installer"

Asegúrese de colocar el directorio $HOME/.composer/vendor/bin (o el directorio equivalente para su sistema operativo) en su $PATH para que el ejecutable laravel pueda ser localizado por su sistema.

Una vez instalado, el comando laravel new creará una nueva instalación de Laravel en el directorio que especifique. Por ejemplo, laravel new blog creará un directorio llamado blog que contendrá una nueva instalación de Laravel con todas las dependencias de Laravel ya instaladas:

laravel new blog

Mediante Composer Create-Project

Alternativamente, también puede instalar Laravel con el comando Composer create-project en su terminal:

composer create-project --prefer-dist laravel/laravel blog

Servidor de Desarrollo Local

Si tiene PHP instalado localmente y desea utilizar el servidor de desarrollo integrado de PHP para su aplicación, puede utilizar el comando Artisan serve. Este comando iniciará un servidor de desarrollo en http://localhost:8000:

php artisan serve

Por supuesto, las opciones de desarrollo local más robustas están disponibles a través de Homestead y Valet.

Configuración

Directorio Público

Después de instalar Laravel, usted debe configurar el documento de su servidor web / web root para que sea el directorio public. El index.php en este directorio sirve como controlador frontal para todas las solicitudes HTTP que entran en su aplicación.

Archivos de configuración

Todos los ficheros de configuración del framework Laravel se almacenan en el directorio config. Cada opción está documentada, así que siéntase libre de revisar los archivos y familiarizarse con las opciones disponibles para usted.

Permisos de Directorio

Después de instalar Laravel, es posible que necesite configurar algunos permisos. Los directorios dentro del almacenamiento y los directorios bootstrap/cache deben poder ser escritos por su servidor web o Laravel no se ejecutará. Si está utilizando la máquina virtual Homestead, estos permisos ya deberían estar establecidos.

Clave de aplicación

Lo siguiente que debe hacer después de instalar Laravel es configurar la clave de aplicación que es una cadena aleatoria. Si instaló Laravel a través de Composer o el instalador de Laravel, esta clave ya ha sido configurada para usted con el comando

php artisan key:generate

Normalmente, esta cadena debe tener 32 caracteres. La clave se puede establecer en el archivo de entorno .env, si no ha cambiado el nombre del archivo .env.example a .env, debería hacerlo ahora. Si la clave de aplicación no está configurada, sus sesiones de usuario y otros datos encriptados no estarán seguros!

Configuración adicional

Laravel no necesita casi ninguna otra configuración fuera de la caja. Usted es libre de empezar a desarrollar! Sin embargo, es posible que desee revisar el archivo config/app.php y su documentación. Contiene varias opciones como la zona horaria (timezone) y la localización (locate) que puede cambiar según su aplicación.

También puede configurar algunos componentes adicionales de Laravel, como por ejemplo:

• Cache (Caché)
• Database (Base de datos)
• Session (Sesión)

Configuración del servidor web

URLs bonitas

Apache

Laravel incluye un archivo public/.htaccess que se utiliza para proporcionar URLs sin el controlador frontal index.php en la ruta. Antes de usar Laravel con Apache, asegúrese de habilitar el módulo mod_rewrite para que el servidor acepte el archivo .htaccess.

Si el archivo .htaccess que se viene con Laravel no funciona con su instalación de Apache, pruebe esta alternativa:

Options +FollowSymLinks
RewriteEngine On

RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^ index.php [L]

Nginx

Si está utilizando Nginx, la siguiente directiva en la configuración de su sitio dirigirá todas las solicitudes al controlador frontal index.php:

location / {
    try_files $uri $uri/ /index.php?$query_string;
}

Por supuesto, al usar Homestead o Valet, las URLs bonitas serán configuradas automáticamente.