Crear un proyecto de laravel 12 en ubuntu 12

Muchos de nosotros nos encontramos más de una vez con el problema de como se crea un proyecto de laravel 12, acá te enseñaremos.

Debemos dejar en claro que en el sitemas de ubuntu 24.04 o versiones anteriores o posteriores que vengan, el proyecto de laravel, debe tener un servidor local para realizar las pruebas, que es por buena practica.

Así nos aseguramos que todo lo que estamos creando se vea de forma real en un servidor, aunque laravel a través de artisan ya tiene su propio server, es más conveniente trabajar con uno local.

Así podemos trabajar con url locales como si tuviéramos un dominio propio.

Te invito a que leas estos artículos antes de empezar con la instalación de los componentes de laravel, ya que este articulo esta basado bajo esos artículos.

Montar servidor Lamp Ubuntu 24.04

Host virtuales en ubuntu server 24.04

si ya tienes instalado composer y node js, salta los pasos directamente hasta CREANDO EL PROYECTO DE LARAVEL 12

INSTALAR COMPOSER

Instalar composer realmente es fácil, pero para laravel debemos también agregar una línea de código en nuestro bashrc, que lo explicaremos más adelante.

Si te quieres asegurar que la información que te estoy entregando, puedes visitar el sitio de composer en la sección de descarga. Puede que resulte alguna diferencia, si ha pasado algún tiempo.

Abre la terminal y copia este código y dale a enter.

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php -r "if (hash_file('sha384', 'composer-setup.php') === 'ed0feb545ba87161262f2d45a633e34f591ebb3381f2e0063c345ebea4d228dd0043083717770234ec00c5a9f9593792') { echo 'Installer verified'.PHP_EOL; } else { echo 'Installer corrupt'.PHP_EOL; unlink('composer-setup.php'); exit(1); }"
php composer-setup.php
php -r "unlink('composer-setup.php');"

Después de realizar la descarga, procedemos a mover el archivo para que quede para todo el sistema.

sudo mv composer.phar /usr/local/bin/composer

Ahora viene la parte importante de composer para dejar habilitada la instalación de laravel, así nos ahorramos tiempo buscando y editando a posterior los archivos para dejarlos listos para trabajar con blade y vite.

Debes abrir el archivo bashrc que se encuentra oculto en la carpeta personal de tu sistema, esto queda en /home/tu_nombre_de_usuario, lo puedes editar de forma directa ya que tu tienes los permisos para ello.

Si no lo aprecias, debes presionar las teclas control+h y estos archivos quedaran a la vista, recuerda después volver a presionar la combinación de teclas para dejarlos ocultos y protegerlos en caso de que los borremos o no queramos editar.

Al final del archivo bashrc agrega la siguiente linea:

export PATH="~/.config/composer/vendor/bin:$PATH"

Una vez agregado, simplemente graba las modificaciones, si no tienes abierta la terminal, procede a abrirla con control+alt+t. y copia y pega el comando que te dejo, luego presiona enter.

source ~/.bashrc

Debes cerrar la terminal bash y volver a abrirla, si se abre totalmente limpia, quiere decir que la linea que agregaste en bashrc esta correcta y no quedó nada corrupto.

INSTALAR NODEJS

Por defecto Ubuntu 24.04 y versiones anteriores no traen la versión de node 22, que a la fecha de hoy es la estable, si no que son versiones anteriores, en el caso de la versión 24.04, node es v18.

Con el siguiente comando nos aseguramos que la versión que descargaremos sera la 22, si tu quieres una versión más nueva, puedes cambiar el 22 por 23 o 24, etc, ahí tienes que ver en que versión se encuentra cuando veas este articulo.

curl -fsSL https://deb.nodesource.com/setup_22.x -o nodesource_setup.sh

creamos un archivo que estará culto para la instalación de node.

sudo -E bash nodesource_setup.sh

Una vez descargado procedemos con la instalación de nodejs versión 22

sudo apt install -y nodejs

Ahora revisa la versión que te aparece en la terminal.

node -v

AGREGANDO EL INSTALADOR DE LARAVEL 12

Para poder manejar de mejor manera nuestras creaciones de proyectos usaremos el instalador de laravel, ya que este se encarga de configurar el proyecto de forma directa a diferencia de composer, que solo agrega los archivos sin configuración previa.

En la pagina oficial de laravel 12, podemos obtner este mismo codigo que debes aplicar desde la terminal bash en nuestro computador.

composer global require laravel/installer

Ya una vez agregado al sistema, ya podemos realizar los pasos para crear nuestro proyecto que lo llamaremos crud.

CREANDO EL PROYECTO DE LARAVEL 12

Como buenas practicas en la programación es bueno organizar nuestros proyectos, como se tratarán de laravel, crearemos una carpeta llamada laravel dentro de www.

Abre tu terminal bash he ingresa el siguiente comando:

sudo mkdir /var/www/laravel

Ya hemos creado la carpeta contenedora de nuestros proyectos, pero como lo hicimos como usuario root, debemos cambiar los permisos para poder escribir dentro de ella.

sudo chmod 777 -R /var/www

Ya con eso otorgamos los permisos para cualquier usuario y carpetas que se encuentren dentro de www de apache.

Ahora accedemos a la carpeta para empezar a crear el proyecto a través, del instalador.

cd /var/www/laravel

Ya estando dentro de la carpeta laravel, ejecutamos el comando de laravel new con el nombre del proyecto, en este caso crud y esperamos a que nos empiecen a aparecer los mensajes de pre configuración.

En la terminal digitamos lo siguiente:

laravel new crud

Solo elige la opción de none, ya que crearemos un proyecto limpio

Solo elige Pest como Framework de trabajo

Esperamos un momento a que proceda con los archivos que se descargaran.

Nos consulta que base de datos vamos a usar, nosotros usaremos mysq-server por lo tanto el modo de conexión sera por Mysql.

En esta parte nos pregunta si deseamos realizar una migración, por el momento solo coloca que no, porque se configurará a posterior, por defecto el archivo .env que trae laravel esta con un usuario root sin password y en la mayoría de servidores, en el caso de nosotros uno local, esta cuanta con una password.

Esperamos que se agreguen los archivos restantes.

Nos consulta si queremos agregar npm a nuestro proyecto, le decimos que Yes, porque trabajaremos con muchas librerías que trae por defecto en una carpeta llamada node_modules.

Se acabá de terminar de crear nuestro proyecto de laravel 12, llamado crud, y este se encuentra en la carpeta /var/www/laravel/crud.

Como nota adicional npm cuando se agrega por primera vez, te indica que actualizes a una nueva versión, solo basta con copiar lo siguiente y listo.

Fijese bien la versión que entrega npm, para que sea la misma, puede que cuando leas este articulo, haya una versión mucho más actualizada.

sudo npm install -g npm@11.6.2

Abre tu navegador y coloca la siguiente url http://crud.test

Puede que aparezca este error, pero para ello, repararemos los errores que nos irán apareciendo.

Esto nos indica que laravel no se puede conectar a la base de datos, ya que la configuración es errónea, abre tu archivo .env del proyecto, usaremos visual studio code para esta ocasión como editor de texto.

si nos fijamos en la imagen anterior, debemos realizar algunos cambios.

DB_USERNAME=root (Debes colocar el usuario de la base de datos, en este caso root)
DB_PASSWORD=12345 (Coloca el password de conexión a la base de datos, por defecto en nuestro archivo .env viene vació).
APP_URL=http://crud.test (En este campo agrega la url con la que trabajarás, en este caso crud.test)

Ahora procedemos con la migración, en la terminal de visual studio code o en bash, dentro de la carpeta de nuestro proyecto, colocamos php artisan migrate y se crearán todas las tablas principales de nuestro proyecto en la base de datos.