Crear un proyecto en laravel

Utilizando la consola de GitBash y situado en la carpeta previa a donde queramos crear el proyecto ejecutar vía composer.

Por ejemplo si se utiliza XAMP, colocarse en htdocs

cd /c/xamp/htdocs

Entonces ejecutar el comando para instalación con composer

composer global require laravel/installer

Y crear después el nombre del proyecto con el comando

laravel new nombredemiproyecto

Instalación con JetStream

También se puede instalar el paquete de JetStream al mismo tiempo, añadiendo --jet

Requiere instalación previa de Node.js, para poder instalar y compilar JetStream y Livewire.

Abrir la consola de GitBash y situarse en la carpeta donde se va a crear el nuevo proyecto.

laravel new nombredemiproyecto --jet

Esta opción pide instalar Livewire o inertia, que son dos formas de dar estilos al proyecto. En mi caso me siento más cómodo trabajando con Livewire.

Opción [0] = Instalar Livewire
Opción [1] = Instalar Inertia

Comenzará la descarga e instalación de componente necesarios.

Después pide ejecutar los comandos npm install && npm run dev, para instalar y compilar Livewire. Es necesario tener instalado Node.js para poder ejecutar estos comandos.

Desde la consola PowerSell o GitBash , entrando en el directorio del proyecto creado nombredemiproyecto, ejecutar:

cd nombredemiproyecto
npm install 
npm rund dev

Al instalar JetStream requiere ejecutar migraciones. Al ser un proyecto nuevo, hay que crear una base de datos donde ejecutar la migración.

Crear base de datos con phpmyadmin y anotar dirección, usuario y contraseña generados.

Revisar el fichero .env que la configuración de acceso a la base de datos es correcta, por ejemplo una base de datos local

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=nombredelabasededatos
DB_USERNAME=root
DB_PASSWORD=

Ahora ya sí se puede ejecutar la migración para crear las primeras tablas básicas para el panel de JetStream.

php artisan migrate

Comprobación de instalación correcta

Sin instalar JetStream , al entrar a la url debe de aparecer la página principal de laravel.

Con JetStream además aparece un menú superior derecho con dos opciones "Login" y "Register".

Posibles Errores

Puede que al acceder al panel de "Login" o "Register" no se visualice bien la página. Esto es porque las direcciones relativas a los estilos css no están acorde con la configuración del fichero .env situado en el raíz del proyecto.

Para solucionarlo puedes optar por:

1. En acceso a localhost 127.0.0.1 se pone en la url el nombre del proyecto seguido de la carpeta public. Por su parte el fichero de configuración .env poner la línea

http://localhost/nombredemiproyecto/public/

APP_URL=http://localhost/nombredemiproyecto

2. Configurando una url local en caso de tener un servidor web local tipo XAMP en Windows.

Añadir en el fichero hosts situado para windows 10 en C:\Windows\System32\drivers\etc\hosts, la línea 127.0.0.1 nombredemiproyecto.test.

Para ello ejecutar el Notepad como administrador, añadir y guardar.

Después abrir el fichero de configuración de apache C:\xampp\apache\conf\extra\httpd-vhosts.conf

Añadir el código solo una vez al comienzo del fichero

<VirtualHost *>
	DocumentRoot "c:\xampp\htdocs"
	ServerName localhost
</VirtualHost>

Y el siguiente código para cualquier url local a configurar

<VirtualHost *>
	DocumentRoot "c:\xampp\htdocs\nombredemiproyecto\public"
	ServerName nombredemiproyecto.test
	<Directory "c:\xampp\htdocs\nombredemiproyecto\public">
		Options All
		AllowOverride All
		Require all granted
	</Directory>
</VirtualHost>

Reiniciar servidor web apache para que tome la nueva configuración y acceder a la nueva url http://nombredemiproyecto.test

Mi recomendación es crear una url local, ya que solo se configura una vez y las rutas quedan bien configuradas de cara a desplegar la aplicación en un servidor en internet.