In this post, we will set our development environment with PHP, Laravel, MariaDB/MySQL, and Valet Linux; yeah, the exclusive macOS development tool working on Linux ;D.
Install MariaDB
To install MariaDB, open the terminal, and type the following command:
sudo apt install mariadb-server mariadb-client
After the installation concludes, test the following commands in that specific order to check if the installation was successful:
sudo systemctl stop mariadb.service
sudo systemctl start mariadb.service
sudo systemctl enable mariadb.service
After verifying the installation was successful, we need to run the mysql_secure_installation, to set MariaDB correctly in our development environment:
sudo mysql_secure_installation
After you execute the command, please answer the following questions:
- Enter current password for root (enter for none): Just press enter
- Set root password? [Y/n]: Y
- New password: Write a secure password
- Re-enter new password: Repeat the password
- Remove anonymous users? [Y/n]: Y
- Disallow root login remotely? [Y/n]: Y
- Remove test database and access to it? [Y/n]: Y
- Reload privilege tables now? [Y/n]: Y
Restart MariaDB's service:
sudo systemctl restart mariadb.service
Then, access to MariaDB through the terminal:
sudo mariadb -u root -p
Or
sudo mysql -u root -p
Remember that MariaDB is fully compatible with MySQL ;).
We need to write the password that we defined in the mysql_secure_installation process in the following SQL statement. This also helps to access MariaDB without sudo on the terminal:
GRANT ALL PRIVILEGES ON *.* TO 'root'@'localhost' IDENTIFIED BY "your_password";
Now exit from MariaDB by pressing: Ctrl+C on the terminal.
Install PHP on Linux
This is very straight; forward we only need to run the following command:
sudo apt install php libapache2-mod-php php-common php-mbstring php-xmlrpc php-soap php-gd php-xml php-mysql php-cli php-mcrypt php-zip php-curl php-sqlite3 php-pgsql
And then open php.ini file to make some adjustments:
sudo nano /etc/php/7.X/apache2/php.ini
Modify the following variables:
memory_limit = 256M
upload_max_filesize = 64M
cgi.fix_pathinfo=0
We save the changes by pressing Ctrl+O and exit with Ctrl+X.
Install Laravel on Linux
We need composer installed in our system to do that, we can install it with:
sudo apt install composer
And now install Laravel:
composer global require laravel/installer
Now we need to add Laravel in our $PATH variable, to make "laravel" a recognizable command:
sudo nano .bashrc
If you are using zsh:
sudo nano .zshrc
Scroll down to the last line of the file and add the following:
export PATH="$HOME/.config/composer/vendor/bin:$PATH"
We save the changes by pressing Ctrl+O and exit with Ctrl+X.
And to force our shell to read the changes, execute:
source .bashrc
If you are using zsh:
source .zshrc
Now we can create a Laravel app:
laravel new laravel-app
If you want to use Laravel 7, try with the following commands and ensure that the PHP version you installed is PHP 7 and not PHP 8:
composer create-project laravel/laravel=^7 laravel-app --prefer-dist
If it does not work try replacing the ^ with >:
composer create-project laravel/laravel=>7 laravel-app --prefer-dist
It should create a Laravel app without problems.
Install Valet Linux
Finally, execute:
composer global require cpriego/valet-linux
If it throws an error, please execute:
sudo apt install php-curl
Try again and now it should work.
Now execute the installation process:
valet install
This also could throw an error, if that's the case, please force the shell to read the changes as we did before:
source .bashrc
If you are using zsh:
sudo nano .zshrc
We need to ensure that we update our $PATH environment variable correctly on the previous steps.
Now valet should throw an error about missing dependencies, to solve that we simply run:
sudo apt-get install network-manager libnss3-tools jq xsel
Now it should install valet correctly:
valet install
But if you have another error related with nginx, you need to stop the service that is running in the same port as nginx, if it's apache who is provoking this problem you can simply stop the apache's service:
sudo systemctl stop apache2.service
And try again:
valet install
To verify everything is ok, run:
ping valet.test
And after a few seconds it should say something like this:
X packets transmited, X received...
If that's the case, congrats! you successfully installed Valet Linux!
Now we need to set the directory where we are going to create Laravel or PHP projects:
cd directory/where/you/are/going/to/work
And execute:
valet park
Now create a folder called: phpinfo, inside the create a file called index.php and in the file, we can write something to check its working:
<?php echo phpinfo();
And finally, we write the following URL in our browser:
It should display info about PHP without errors.
You can custom the domain if you don't like .test with:
valet domain dev
And now to get access you need to change your current URL with the following: phpinfo.dev/index.php
And that's it, hope you enjoy it, if you want to see how to do it in fedora and manjaro, please comment it :D.