Stars: 877
Forks: 328
Pull Requests: 58
Issues: 63
Watchers: 57
Last Updated: 2023-03-15 08:34:51
Laravel Boilerplate / Starter Kit with Gentelella Admin Theme
License: MIT License
Languages: PHP, Shell, Dockerfile, Blade
Laravel Boilerplate provides a very flexible and extensible way of building your custom Laravel applications.
analytics.php
and template ga.blade.php
ToJs
to ease work with JavaScript variables using blade directive @tojs
Meta
blade directive @meta
to ease work with meta tags & propertiesgravatar.php
laravel.log
trans()
method replaced by __()
in order to support internationalization via JSON resourcesConfirmEmail
on user account confirmationcreate_users_table.php
; fields added active, confirm and deleted_at for soft deletionTo be able to run Laravel Boilerplate you have to meet the following requirements:
$ wget https://getcomposer.org/composer.phar
$ chmod +x composer.phar
$ mv composer.phar /usr/local/bin/composer
$ yum install npm
$ git clone https://github.com/Labs64/laravel-boilerplate.git
$ cd laravel-boilerplate
.env.example
to .env
and modify according to your environment$ cp .env.example .env
$ composer install --prefer-dist
$ php artisan key:generate
$ npm install
$ npm run dev
$ php artisan migrate --seed
If you get an error like a PDOException
try editing your .env
file and change DB_HOST=127.0.0.1
to DB_HOST=localhost
or DB_HOST=mysql
(for docker-compose environment).
If you get a password error try this command:
# ALTER USER 'root'@'%' IDENTIFIED WITH mysql_native_password BY 'root';
To start the PHP built-in server
$ php artisan serve --port=8080
or
$ php -S localhost:8080 -t public/
Now you can browse the site at http://localhost:8080 🙌
Here is a Docker based local development environment prepared, which provides a very flexible and extensible way of building your custom Laravel applications.
This project is based on docker-compose. By default, the following containers are started: laravel-env (centos:7 based), mysql, nginx. Additional containers (phpmyadmin, mailhog) are externalized into docker-compose.utils.yml
. The /var/www/laravel-boilerplate
directory is the web root which is mapped to the nginx container.
You can directly edit configuration files from within the repo as they are mapped to the correct locations in containers.
To be able to run Laravel Boilerplate you have to meet the following requirements:
$ git clone https://github.com/Labs64/laravel-boilerplate.git
.env.example
to .env
and modify according to your environment (make sure database host set to DB_HOST=mysql
)$ cp .env.example .env
$ docker-compose up -d # to start base containers
or
$ docker-compose -f docker-compose.yml -f docker-compose.utils.yml up -d # to start base and utils containers
$ docker exec laravel-boilerplate_laravel-env_1 ./dockerfiles/bin/prj-build.sh
or
$ docker-compose run --rm laravel-boilerplate_laravel-env_1 ./dockerfiles/bin/prj-build.sh
Now you can browse the site at http://localhost:80 🙌
$ docker-compose down
or
$ docker-compose -f docker-compose.yml -f docker-compose.utils.yml down
Check out project wiki pages for modules configuration and troubleshooting. For more detailed instructions on how to use Laravel and it's extensions, check out the full Laravel documentation.
Fork the repository, read the CONTRIBUTE file and make some changes. Once you're done with your changes send a pull request and check CI validation status. Thanks!
Thank you to all the contributors on this project. Your help is much appreciated!
For bugs, questions and discussions please use the GitHub Issues.
This boilerplate is open-source software licensed under the MIT license.