No siempre es posible disponer de un acceso alto al servidor, ya que los clientes de tama\u00f1o medio o peque\u00f1o suelen tener limitados los costes. En este caso nos debemos desplegar nuestra aplicaci\u00f3n en un servidor compartido. Tienen unos costes m\u00e1s ajustados, pero tambi\u00e9n m\u00e1s limitados los accesos.<\/p>\n\n\n\n
Uno de los primeros l\u00edmites que tienen los servidores compartidos est\u00e1 en el acceso a la consola o terminal. Esta limitaci\u00f3n provocar\u00e1 que no podamos ejecuta de forma directa ninguno de los comandos de Artisan. Y aqu\u00ed empiezan las complicaciones, porque debemos buscar una forma alternativa para realizar esos mismos pasos.<\/p>\n\n\n\n
Laravel es un framework de desarrollo que tiene muchas ventajas y ofrece asistencias para un desarrollo m\u00e1s \u00e1gil, pero su despliegue en hosting compartidos no es tan sencillo, puesto que gran parte de las herramientas que nos ofrece se utilizan desde el terminal de comandos.<\/p>\n\n\n\n
Art\u00edculo recomendado: Por qu\u00e9 es un buen momento para aprender Laravel<\/a><\/p>\n\n\n\n Un entorno de desarrollo es ligeramente diferente a un entorno de producci\u00f3n. Especialmente en lo relativo a seguridad. Por este motivo, debemos verificar que hacemos las adaptaciones necesarias en cuanto a configuraci\u00f3n.<\/p>\n\n\n\n Por despiste o desconocimiento, son muchas las aplicaciones web que tienen el modo de depuraci\u00f3n activo.<\/p>\n\n\n\n La depuraci\u00f3n es muy \u00fatil en desarrollo para detectar el origen de los errores y corregirlo, pero es un gran agujero de seguridad si esta informaci\u00f3n la exponemos en internet.<\/p>\n\n\n\n En estos volcados a pantalla se muestran rutas e incluso valores que pueden dar pistas a los usuarios maliciosos para atacar nuestra aplicaci\u00f3n y acceder a nuestros datos.<\/p>\n\n\n\n Vamos al fichero config\/app.php y verificamos los valores de las claves env, debug y url se obtiene del fichero de configuraci\u00f3n de entorno. Esto lo vemos claramente porque utilizan la funci\u00f3n env para obtener el valor de las claves asociadas<\/p>\n\n\n El segundo par\u00e1metro es un valor por defecto, por si no se encontrase la clase en el fichero, as\u00ed que tampoco le prestaremos demasiada atenci\u00f3n.<\/p>\n\n\n\n A continuaci\u00f3n revisaremos el fichero .env. Si has mantenido el orden inicial, algo altamente recomendable, deber\u00edas tener las siguientes l\u00edneas al inicio:<\/p>\n\n\n Nos centraremos en APP_ENV y en APP_DEBUG. La primera nos indica el entorno, que inicialmente tendr\u00e1 el valor local, pero que a la hora de pasar a producci\u00f3n cambiaremos por production<\/em>. M\u00e1s importante es APP_DEBUG, que en desarrollo nos conviene que tenga valor true<\/em>, pero al pasar a producci\u00f3n debe tener valor false<\/em>. De lo contrario, si alguna vez se produce un error no controlado en nuestra aplicaci\u00f3n, me mostrar\u00e1 todo nuestro c\u00f3digo fuente por pantalla.<\/p>\n\n\n\n Por \u00faltimo, y muy importante, antes de desplegar en producci\u00f3n, hay que cambiar la clave de cifrado de datos. Laravel utiliza la funci\u00f3n de cifrado AES (Advanced Encription Standard) y para encriptar datos cifrados de base datos o cookies va a utilizar el valor de la clave APP_KEY. Adem\u00e1s, se utiliza para generaci\u00f3n te token o firmas, por lo que antes de desplegar la aplicaci\u00f3n, regeneramos esta clave ejecutando desde un terminal la siguiente instrucci\u00f3n<\/p>\n\n\n Adem\u00e1s, debemos revisar los distintos par\u00e1metros de configuraci\u00f3n por si hay cambios respecto a nuestro entorno local. Dentro de estos par\u00e1metros a modificar, estar\u00e1n los bloques correspondientes al env\u00edo de correo, base de datos, Redis o AWS<\/p>\n\n\n\n Ahora s\u00ed, podemos pasar a copiar nuestros ficheros desde FTP.<\/p>\n\n\n\n Es posiblemente la parte m\u00e1s sencilla del despliegue de una aplicaci\u00f3n Laravel, puesto que no hay que hacer pr\u00e1cticamente nada distinto a cuando subimos im\u00e1genes para una web est\u00e1tica.<\/p>\n\n\n\n Accedemos al servidor remoto por FTP con nuestro cliente favorito y copiamos los ficheros de nuestro proyecto Laravel.<\/p>\n\n\n\n Podemos copiar todos con tranquilidad porque estar\u00e1n protegidos por la seguridad de Laravel, pero algunos no nos ser\u00e1n necesarios.<\/p>\n\n\n\n Como veremos un poco m\u00e1s adelante, la carpeta database<\/em>, no es necesaria, puesto que la base de datos no la crearemos mediante migraciones y seeders<\/em>.<\/p>\n\n\n\n Tampoco necesitaremos la carpeta test<\/em>, puesto que no es habitual que ejecutemos pruebas en producci\u00f3n despu\u00e9s del despliegue. Si dentro de tu aplicaci\u00f3n has creado tests automatizados, debes copiar la carpeta y ejecutar los test antes de eliminar la carpeta.<\/p>\n\n\n\n Por \u00faltimo, revisa la carpeta storage <\/em>y borra todo el contenido de logs y revisa los ficheros que haya subido tu aplicaci\u00f3n, porque la mayor\u00eda (por no decir todos) corresponder\u00e1n a pruebas en desarrollo.<\/p>\n\n\n\n Las migraciones en este caso nos van a servir de poco, porque al no poder utilizar Artisan, no podremos ejecutarlas y tampoco cargar los Seeder de apoyo para esos datos iniciales<\/p>\n\n\n\n En una aplicaci\u00f3n con un modelo de datos grande y con varias tablas auxiliares, podemos tener varias tablas que alimentamos con Seeder. Tanto esta carga de datos, como la propia creaci\u00f3n de la base de datos, es algo que no podremos hacer sin ejecutar comandos.<\/p>\n\n\n\n En este caso, lo vamos a hacer exportando la base de datos. Pero antes, debemos asegurar que no contiene datos procedentes de pruebas. Desde un terminal ejecutamos<\/p>\n\n\n Con esta instrucci\u00f3n regeneramos todo el modelo y a continuaci\u00f3n podemos ejecutar todos los seeder con<\/p>\n\n\n Y la base datos ya est\u00e1 \u201climpia\u201d. Ahora vamos a nuestro cliente de base de datos y exportamos nuestra base de datos a un fichero SQL<\/p>\n\n\n\n Que luego importaremos desde el cliente que nos ofrezca nuestro hosting compartido, normalmente ser\u00e1 phpMyAdmin. Para ello, creamos la base de datos y le asignamos el mismo nombre que hab\u00edamos definido en el fichero .env adem\u00e1s nos aseguraremos de haber creado el usuario y contrase\u00f1a del mismo fichero con los permisos m\u00e1s altos sobre la base de datos.<\/p>\n\n\n\n Una vez creada la nueva base de datos, la seleccionamos desde phpMyAdmin e importamos tanto el esquema como los datos:<\/p>\n\n\n\n Lo normal, es acabar el despliegue de nuestra aplicaci\u00f3n en este punto, por lo que llega el momento de probar y verificar que todo est\u00e1 funcionando conforme a lo que deber\u00eda.<\/p>\n\n\n\n En muchos casos comprobaremos que no hay ning\u00fan error adicional o seg\u00fan vayan surgiendo los corregimos, pero nos encontraremos con un \u00faltimo obst\u00e1culo, la ruta simb\u00f3lica para los ficheros subidos desde la propia aplicaci\u00f3n.<\/p>\n\n\n\n Por el modelo de seguridad de Laravel, cuando subimos un fichero lo dejamos en una ruta protegida y ofrecemos un enlace simb\u00f3lico que tiene que estar correctamente mapeado para poder recuperar estos ficheros desde la aplicaci\u00f3n.<\/p>\n\n\n\n Desde nuestro entorno de desarrollo lo solucion\u00e1bamos ejecutando el comando<\/p>\n\n\n Pero al no poder ejecutar comandos en nuestro hosting compartido, debemos simularlos. Volvemos a nuestro entorno de desarrollo y abrimos el fichero web.php. En un punto del mismo en el que no est\u00e9n protegidas las rutas por ning\u00fan middleware incorporamos una nueva ruta que va a realizar una llamada a Artisan:<\/p>\n\n\n Subimos el fichero web.php por ftp a nuestro hosting y abrimos la ruta \/symlink tras ejecutarse no debe dar una pantalla en blanco, puesto que no le hemos a\u00f1adido ninguna informaci\u00f3n y con esto ya lo tendr\u00edamos<\/p>\n\n\n\n Solamente quedar\u00eda eliminar esa ruta y volver a subir el fichero.<\/p>\n\n\n\n Esta acci\u00f3n para llamar a Artisan, nos sirve con cualquier comando, solamente debemos incorporarle como par\u00e1metro a call el comando y como segundo par\u00e1metro la lista de argumentos en forma de array asociativo<\/p>\n\n\n Esto lo necesitaremos, por ejemplo si queremos optimizar nuestro proyecto con cach\u00e9 de eventos, rutas o vistas, o si hacemos una actualizaci\u00f3n que requiere borrar cache.<\/p>\n\n\n\n De esta forma podemos tener una ruta adicional<\/p>\n\n\n Que nos borrar\u00e1 la cache y la regener\u00e1.<\/p>\n\n\n\n El despliegue de una aplicaci\u00f3n suele ser tedioso y para ello, siempre podemos generar nuestros propios scripts o utilizar herramientas de automatizaci\u00f3n, como es el caso de Laravel Forge<\/a>. <\/p>\n\n\n\n Pero si no podemos utilizarlas o no consideramos incorporar su coste de licenciamiento a nuestro proyecto, podemos hacerlo de forma totalmente artesana siguiendo estos pasos.<\/p>\n\n\n\nPasos previos<\/h2>\n\n\n\n
'env'<\/span> => env('APP_ENV'<\/span>, 'production'<\/span>),\n\u00a0 \u00a0 'debug'<\/span> => (bool) env('APP_DEBUG'<\/span>, false<\/span>),\n\u00a0 \u00a0 'url'<\/span> => env('APP_URL'<\/span>, 'http:\/\/localhost'<\/span>),<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\nAPP_NAME=Laravel\nAPP_ENV=local\nAPP_KEY=base64:X0hgHxJ8c88yUwq2LxHRRrUQOaDeIqKsvjmZAP9dsIo=\nAPP_DEBUG=true<\/span>\nAPP_TIMEZONE=UTC\nAPP_URL=http:\/\/localhost<\/span><\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\nphp<\/span> artisan<\/span> key<\/span>:generate<\/span><\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\nCopiando los ficheros<\/h2>\n\n\n\n
La base de datos<\/h2>\n\n\n\n
php<\/span> artisan<\/span> migrate<\/span>:refresh<\/span><\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\nphp<\/span> artisan<\/span> db<\/span>:seed<\/span><\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n![\"\"](\"https:\/\/www.codemotion.com\/magazine\/wp-content\/uploads\/2024\/05\/DEPL_001-1024x603.png\")
<\/figure>\n\n\n\n![\"\"](\"https:\/\/www.codemotion.com\/magazine\/wp-content\/uploads\/2024\/05\/DEPL_002-1024x622.png\")
<\/figure>\n\n\n\nA probar y primeros errores<\/h2>\n\n\n\n
Enlaces simb\u00f3licos<\/h2>\n\n\n\n
php<\/span> artisan<\/span> storage<\/span>:link<\/span><\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\nRoute::get('\/symlink'<\/span>, function<\/span> ()<\/span> <\/span>{\n\u00a0 \u00a0 Artisan::call('storage:link'<\/span>);\n});<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\nArtisan::call('comando:nombre'<\/span>, [ 'argumento1'<\/span> => valor1, 'argumento2'<\/span> => valor2]);<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\nRoute::get<\/span>('\/clearcache\u2019, function () {\n\u00a0 \u00a0 Artisan<\/span>::call('optimize:clear'<\/span>);\n\u00a0 \u00a0 Artisan::call('optimize'<\/span>);\n});<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\nConclusi\u00f3n<\/h2>\n\n\n\n
\u00danete a nuestra comunidad<\/strong><\/pre>\n\n\n\n
Ser parte de la comunidad tech de Codemotion te permitir\u00e1 potenciar tu experiencia y enfrentar nuevos desaf\u00edos que impulsar\u00e1n tu carrera. Aprender\u00e1s nuevas habilidades t\u00e9cnicas y crecer\u00e1s junto a otros miembros mediante el intercambio de opiniones y la creaci\u00f3n conjunta. <\/pre>\n\n\n\n
Nuestra comunidad de Telegram es para ti. All\u00ed encontrar\u00e1s el mejor networking, art\u00edculos high-tech, debates de tendencias tech y beneficios exclusivos. S\u00famate aqu\u00ed.<\/a><\/pre>\n\n\n\n
\u00a1Nos vemos en Codemotion!<\/pre>\n\n\n\n