The simple guide to deploy Laravel and Lumen application on shared hosting.
For a quick version of the guide (many of you might already read about it), read my post on medium, "The simple guide to deploy Laravel 5 application on shared hosting"
Before trying to deploy a Laravel application on a shared hosting, you need to make sure that the hosting services provide a fit requirement to Laravel. Basically, following items are required for Laravel 5.2:
- PHP >= 5.5.9
- OpenSSL PHP Extension
- PDO PHP Extension
- Mbstring PHP Extension
- Tokenizer PHP Extension
Well, it also depends on the Laravel version you want to try to install, checkout the appropriate version of Laravel server requirements documentation.
Next, you need to have the SSH access permission for your hosting account; otherwise, none of these will work.
Besides PHP and those required extensions, you might need some utilities to make deployment much easier.
I guess that's enough for good. Please refer to below sections to learn more about deployment.
Let's get started by understanding how we should organize the Laravel application structure. At first, you will have this or similar directories and files in your account,
.bash_history
.bash_logout
.bash_profile
.bashrc
.cache
.cpanel
.htpasswds
logs
mail
public_ftp
public_html
.ssh
tmp
etc
www -> public_html
...
For the main account which tied with the main domain, the front-end code should stay in public_html
or www
. Since, we don't want to expose Laravel things (such as, .env, ...) to the outside world, we will hide them.
Create a new directory to store all the code, name it projects
or whatever you want to.
$ mkdir projects
$ cd projects
Alright, from here, just issue a git command to grab the code,
$ git clone http://[GIT_SERVER]/awesome-app.git
$ cd awesome-app
Next step is to make the awesome-app/public
directory to map with www
directory, symbol link is a great help for this, but we need to backup public
directory first.
$ mv public public_bak
$ ln -s ~/www public
$ cp -a public_bak/*.* public/
$ cp public_bak/.htaccess public/
Because we created the symbol link from www
directory to make it become the virtual public
in project, so we have to update the ~/www/index.php
to include to correct paths.
require __DIR__.'/../projects/awesome-app/bootstrap/autoload.php';
$app = require_once __DIR__.'/../projects/awesome-app/bootstrap/app.php';
The hard part is done, the rest is to do some basic Laravel setup. Allow write permission to storage
directory is important,
$ chmod -R o+w storage
Edit your .env
for proper configuration. Don't miss this!
Lastly, update the required packages for Laravel project using composer and add some necessary caches,
$ php composer install
$ php composer dumpautoload -o
$ php artisan config:cache
$ php artisan route:cache
Congratulation! You've successfully set up a Laravel application on a shared hosting service.
1. How to acquire SSH access permission for my account?
Just contact your hosting support, they will need to confirm your identity and will permit your SSH access in no time.
2. Where is git? I can't find it.
git
is often put under this place in CPanel hosting services, /usr/local/cpanel/3rdparty/bin/git
. So you need to provide full path to git
if you want to issue a git
command; or, you can also create an alias for convenient use,
alias git="/usr/local/cpanel/3rdparty/bin/git"
3. How to get composer?
You can use FTP or SCP command to upload composer.phar
to the host after downloading it locally. Or use wget
and curl
to get the file directly on host,
$ wget https://getcomposer.org/composer.phar
or
$ curl -sS https://getcomposer.org/installer | php — –filename=composer
4. Does this work with Lumen?
Well, Laravel and Lumen are like twins, so it applies the same with Lumen.
5. I try to run
composer
but it shows nothing. What is the problem?
You need to provide a proper PHP configuration to run composer
, which means, you cannot execute composer
directly on some hosting service providers. So to execute composer
, you will need to issue this command,
$ php -c php.ini composer [COMMAND]
6. Where can I get the
php.ini
to load forcomposer
?
You can copy the default PHP configuration file php.ini
, which is often at /usr/local/lib/php.ini
, or find it by this command,
$ php -i | grep "php.ini"
The following shared hosting service providers have been tested and worked perfectly 100%.
Works on GeekStorage shared plan but I had to enable PHP 5.6 via .htaccess AddHandler application/x-httpd-php56 .php
If you found any hosting providers that works, please tell me, I will update the list for others to know about them, too.
If you still fail to deploy Laravel applications after following all above steps. Provide me your issue in details, I will help you out.
Free free to fork the project and submit a pull request.