PDF de programación - Laravel 5.5 Documentación oficial

Laravel 5.5

Documentación oficial

Prólogo

¡Colabora!

En Laraveles estamos trabajando duro traduciendo la documentación completa de Laravel. No es una tarea
sencilla y es un camino largo. Buscamos colaboradores comprometidos para finalizar el proceso y ayudar a
mantenerlo.

¡Sí, quiero colaborar!

Traducción del archivo: 100%

Instalación

Instalación

Requisitos del servidor
Instalar Laravel
Configuración

Configuración del servidor Web

URL amigables

Instalación

¿Prefieres aprender con vídeos? Laracasts ofrece una introducción gratuita y
completa a Laravel para los recién llegados al framework. Es un buen lugar para
comenzar tu viaje.

Requisitos del servidor

El framework Laravel tiene unos pocos requerimientos de sistema. Por supuesto estos
requisitos son satisfechos por la máquina virtual Laravel Homestead, por lo que es muy
recomendable utilizar Homestead como su entorno de desarrollo local para Laravel.

No obstante si no está utilizando Homestead, necesitará asegurarse que el servidor cumple
con los siguientes requermientos:

PHP >= 7.0.0

# # # # # # # OpenSSL PHP Extension

PDO PHP Extension

Mbstring PHP Extension

Tokenizer PHP Extension

XML PHP Extension

Instalar Laravel

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

A través del Instalador de Laravel

En primer lugar, descargar al instalador de Laravel usando composer:

composer global require "laravel/installer"

Asegurese de colocar el directorio del proveedor en su $PATH para hacerlo accesible a todo el
sistema de ficheros para que el ejecutable Laravel pueda ser localizado. Este directorio existe
en diferentes sitios dependiendo de su sistema operativo; no obstante, algunas localizaciones
comunes incluyen:

MacOS: $HOME/.composer/vendor/bin

Distribuciones GNU / Linux: $HOME/.config/composer/vendor/bin

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

laravel new blog

Vía composer create-project

También se puede instalar Laravel ejecutando el comando de Composer create-project en la
terminal:

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

Servidor de desarrollo local

Si se tiene PHP instalado localmente y desea utilizar el servidor de desarrollo built-in
(incluido) en PHP para su aplicación, puede utilizar el comando Artisan serve . Este comando
arrancará un servidor de desarrollo accesible en http://localhost:8000 :

php artisan serve

Por supuesto, las opciones más robustas para desarrollo local son Homestead y Valet.

Configuración

Directorio public

Después de instalar Laravel, debería configurar la raíz de su servidor web para que apunte al
directorio public . El archivo index.php en este directorio sirve como front controller para
todas las peticiones HTTP que entren en su aplicación.

Ficheros de configuración

Todos los archivos de configuración de Laravel Framework se encuentran en el directorio
config . Cada opción está documentada, por lo que es más que recomendable navegar entre
los diferentes archivos y conocer las diferentes opciones.

Permisos de directorios

Después de instalar Laravel, puede ser necesario configurar algunos permisos. Los directorios
dentro de storage y de bootstrap/cache deberían tener permisos de escritura para el usuario
del servidor web o Laravel no funcionará. Si se utiliza la máquina virtual Homestead, estos
permisos ya deben estar configurados.

Clave de la aplicación

Lo siguiente que se debe hacer una vez instalado Laravel es establecer la clave de aplicación a
una cadena aleatoria. Si se instala Laravel utilizando Composer o el instalador Laravel, esta
clave se habrá generado automáticamente a través del comando php artisan key:generate .

Normalmente, esta cadena debe contener 32 caracteres de longitud. Esta clave se debe
establecer en el archivo de entorno .env . Si no se ha renombrado el archivo .env.example a
.env , debe hacerse ahora. ¡Si no se establece la clave de aplicación, las sesiones de
usuario y otros datos codificados no serán seguros!

Configuración adicional

Laravel no necesita casi ninguna otra configuración para comenzar. ¡Ya puede empezar a
programar! Sin embargo, puede querer revisar el archivo config/app.php y su
documentación. Contiene varias opciones como timezone y locale que podrías desear
cambiar en función de su aplicación.

También se pueden configurar algunos componentes adicionales de Laravel, tales como:

Cache

Database

Session

Configuración del servidor Web

URL amigables

Apache

Laravel incluye un fichero public/.htaccess que es utilizado para proveer URLs sin el front
controller index.php en la ruta. Antes de servir Laravel con Apache, asegurese de activar el
módulo mod_rewrite para que el servidor respete el fichero .htaccess .

Si el fichero .htaccess que provee Laravel no funciona con su instalación de Apache, intente
está 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 redireccionará
todas las peticiones al controlador frontal index.php :

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

Por supuesto, cuando se utiliza Homestead o Valet, las URLs serán automáticamente
configuradas.

Notas de publicación

Esquema de versiones
Política de Soporte
Laravel 5.5

Esquema de versiones

Las versiones de Laravel siguen la siguiente convención: paradigma.mayor.menor . Los
lanzamientos mayores se producen cada 6 meses (febrero y agosto), mientras que los
menores pueden ocurrir varias veces a la semana. Los lanzamientos menores nunca
contendrán cambios que "rompan" el código.

Al referenciar Laravel framework o sus componentes desde una aplicación o paquete, se debe
indicar alguna restricción de versión como 5.5.* , puesto que los lanzamientos mayores de
Laravel incluyen cambios que podrían "romper" el código. Sin embargo, nos esforzamos por
que el proceso de actualización entre versiones mayores se pueda realizar en un día o menos.

Los cambios de paradigma se separan por años de diferencia y representan cambios
fundamentales en la arquitectura y convenciones del framework. Actualmente, no hay
ningún nuevo paradigma en desarrollo.

¿Por qué Laravel no Utiliza un Versionado Semántico?

Por un lado, todos los componentes opcionales de Laravel (Cashier, Dusk, Valet, Socialite,
etc.) si usan el versionado semántico. Sin embargo, Laravel en sí mismo no lo hace. La razón
es que este sistema de versionado semántico es un modo "reduccionista" de determinar si
dos piezas de código son compatibles. Incluso cuando se utiliza el versionado semántico,
todavía se tiene que instalar el paquete actualizado y ejecutar una batería de tests para estar
seguro de que realmente nada es incompatible con el código base.

Por el contrario, Laravel utiliza un sistema de versiones más comunicativo con el ámbito
actual del lanzamiento. Además, puesto que los lanzamientos menores nunca contienen
cambios con roturas intencionales, no se debería recibir una actualización con rotura si la
restricción de versión sigue la convención paradigma.mayor.* .

# # # # Política de Soporte

Las las versiones LTS –Long Term Support (soporte a largo plazo)– como Laravel 5.5, se
garantizan 2 años de solución de problemas generales y 3 años de soluciones relativas a
seguridad. Estos lanzamientos son los qué más soporte y mantenimiento tienen. Para
lanzamientos generales, se solucionarán problemas durante 6 meses y fallos de seguridad
durante un año.

Laravel 5.5 (LTS)

Laravel 5.5 continua con las mejoras realizadas en Laravel 5.4 añadiendo auto-detección de
paquetes, recursos API / transformaciones, auto-registro de comandos de consola,
encadenado de queued jobs, límites a los queued jobs, intentos de ejecución de trabajos
limitados por tiempo, e-mails renderizables, excepciones reportables y renderizables, mejor
gestión de excepciones, mejoras en las pruebas de bases de datos, reglas de validación
personalizadas, recursos front-end para React, los métodos Route::view y Route::redirect ,
"bloqueos" para los drivers de caché Memcached y Redis, notificaciones bajo demanda,
soporte para Chrome headless en Dusk, atajos para Blade, mejor soporte para proxy y más.

Además, Laravel 5.5 coincide con el lanzamiento de Laravel Horizon, un nuevo panel de
control y sistema de configuración para sus colas basadas en Redis.

Esta documentación resume las mejoras más notables del framework; sin
embargo, siempre están disponibles registros de cambios más completos en
GitHub.

Laravel Horizon

Horizon proporciona un hermoso dashboard y una configuración controlada por código para
sus colas Redis de Laravel. Horizon le permite monitorear fácilmente las métricas clave de su
sistema de cola, tales como el rendimiento del trabajo, el tiempo de ejecución y las fallas del
trabajo.

Toda la configuración se almacena en un único y sencillo archivo de configuración,
permitiendo que su configuración permanezca en el lugar del control del codigo donde todo
su equipo puede colaborar.

Para obtener más información sobre Horizon, consulte la sección full Horizon documentation

## Package Discovery

Hay un tutorial gratuito en video para esta característica disponible en Laracasts.

En versiones anteriores de Laravel, la instalación de un paquete requería normalmente varios
pasos adicionales, como añadir el proveedor de servicios a su archivo de configuración app y
registrar las facades relevantes. Sin embargo, a partir de Laravel 5.5, Laravel puede detectar y
registrar aut