Setting up a Laravel project can be repetitive and time-consuming. To address this, I’ve developed a custom installation script based on my experience, using my Project Template.
This script automates the process of configuring your environment, creating the database, managing dependencies, and setting up Supervisor to manage Laravel queues—saving you time and ensuring consistency.
Introduction
When setting up a new Laravel project, the following steps are often required:
- Configuring environment variables.
- Installing dependencies via Composer and npm.
- Creating the database.
- Setting up Supervisor to manage processes like Horizon.
To streamline this process, the installation script in the bin/ directory automates these tasks, ensuring everything is set up properly in one go.
Where to Find the Installation Script
The main installation script is located at:
-
Installation Script:
bin/install -
Dependency Update Script (Optional):
bin/update-dependencies
These scripts ensure that the project is correctly configured with the necessary dependencies, environment variables, and Supervisor setup.
How to Use the Installation Script
Step 1: Clone the Repository
Start by cloning the repository:
git clone https://github.com/nasrulhazim/project-template.git my-project
cd my-project
Step 2: Run the Installation Script
From the project’s root directory, run the installation script:
./bin/install
What the Installation Script Does
1. Database Creation
The script extracts the project directory name and converts it to snake_case for the database name.
Example:
- Directory:
loop-tag - Database:
loop_tag
If the database doesn’t exist, it is created using MySQL:
mysql -u<DB_USER> -p<DB_PASSWORD> -e "CREATE DATABASE loop_tag;"
2. Environment Configuration
The script updates .env.example with:
-
APP_NAME in Title Case (e.g.,
Loop Tag). -
DB_DATABASE in snake_case (e.g.,
loop_tag).
It then copies .env.example to .env (if it doesn’t already exist) and generates an application key:
php artisan key:generate
3. Composer and npm Dependency Installation
The script installs dependencies if the required directories don’t exist:
- Composer Dependencies:
composer install
-
Update Dependencies Script:
If the
bin/update-dependenciesscript exists, it runs:
bash ./bin/update-dependencies
- npm Dependencies:
npm upgrade
npm audit fix --force
npm run build
If the build modifies any files in the public/ directory, they are committed:
git add public/
git commit -m "Update public/ directory after build"
4. Supervisor Configuration
The script updates the command and log file paths in .config/supervisord.ini:
- Command Path Example:
command=php /var/www/loop-tag/artisan horizon
- Log File Path Example:
stdout_logfile=/var/log/supervisor/loop-tag-horizon.log
If changes are made to supervisord.ini, they are committed:
git add .config/supervisord.ini
git commit -m "Update supervisord.ini with project-specific configurations"
5. README.md Update
The script updates README.md with:
- The GitHub project URL (replacing
nasrulhazim/project-template). - The project name in Title Case (e.g.,
Loop Tag).
Example updates in README.md:
sed -i.bak "s|nasrulhazim/project-template|<your-remote-url>|g" README.md
sed -i.bak "s|Project Template|Loop Tag|g" README.md
rm -f README.md.bak
If changes are detected, they are committed:
git add README.md
git commit -m "Update README.md to reflect project name: Loop Tag"
Troubleshooting
MySQL Database Issues:
Ensure the MySQL service is running:
sudo systemctl start mysql
Permission Issues:
Make sure the install script has the correct permissions:
chmod +x bin/install
Supervisor Issues:
Check the Supervisor logs if Horizon doesn’t start:
tail -f /var/log/supervisor/loop-tag-horizon.log
Dependency Installation Errors:
Verify that Composer and npm are installed:
composer --version
npm --version
Conclusion
Using this installation script ensures that your Laravel project is set up consistently every time, reducing the chance of manual errors. It automates everything from environment configuration to database creation and dependency installation, giving you more time to focus on building your application.
To get started, just follow these two simple steps:
Clone the repository:
git clone https://github.com/nasrulhazim/project-template.git my-project
cd my-project
Run the installation script:
./bin/install
This script is part of the my Project Template and reflects the best practices I’ve developed through my experience working with Laravel projects.
With this automation in place, your Laravel setup becomes fast, consistent, and hassle-free.
Give it a try and enjoy a streamlined development experience!
Photo by Ruben Christen on Unsplash
Top comments (0)