Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/untone-survive/vagrant-lemp
Easy Vagrant setup for Nginx + php-fm (with xDebug) + MySQL
https://github.com/untone-survive/vagrant-lemp
mysql nginx php php71 vagrant xdebug
Last synced: about 1 month ago
JSON representation
Easy Vagrant setup for Nginx + php-fm (with xDebug) + MySQL
- Host: GitHub
- URL: https://github.com/untone-survive/vagrant-lemp
- Owner: untone-survive
- License: mit
- Created: 2018-04-28T15:59:13.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2018-05-15T14:31:02.000Z (over 6 years ago)
- Last Synced: 2024-08-23T14:19:17.962Z (4 months ago)
- Topics: mysql, nginx, php, php71, vagrant, xdebug
- Language: Shell
- Homepage:
- Size: 30.3 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Universal Vagrant + LEMP setup
Easy deployment of Vagrant with Linux (Ubuntu 16.04) + Nginx + Mysql 5.7 + PHP 7.1 (with xDebug enabled) + Composer
Based on [Yii2 advanced template](https://github.com/yiisoft/yii2-app-advanced) Vagrant setup.
## Prerequisites
* Install [Vagrant](https://www.vagrantup.com/docs/installation/)
* Install [Virtualbox](https://www.virtualbox.org/manual/ch01.html#intro-installing)
## Folder structure
```bash
/path/to/your/projects # projects root
/project1.test # actual folder with your project files
/project2.test
...
/projectN.test
/vagrant-lemp # folder with all vagrant data
```
The setup automatically creates Nginx configs for all folders inside the projects root folder.
With the help of [hostmanager](https://github.com/devopsgroup-io/vagrant-hostmanager) plugin the names of your projects folders also become URLs of the local sites. You might want to name them accordingly.
**Pro-tip:**
End your projects folders with `.test`. Because `.dev` is bought by Google and `.local` is used by Apple in their software.
## Installation
Open the root directory for your folders.
```bash
cd /path/to/your/projects
```
Clone this repo
```bash
git clone https://github.com/h8every1/vagrant-lemp.git
cd vagrant-lemp
```
Run Vagrant
```
vagrant up
```
## Configuring Vagrant
Before starting Vagrant for the first time you might want to do a little setup.
Copy and edit main config file
```bash
cp ./config/vagrant-local.example.yml ./config/vagrant-local.yml
```
If you don't do it manually, the `vagrant-local.yml` config file will be created automatically on first run.
Edit newly created config file with your favorite text editor
```bash
vim ./config/vagrant-local.yml
```
You can provide your [GitHub token](https://github.com/blog/1509-personal-api-tokens) which will be used by Composer. You can generate it here: https://github.com/settings/tokens If you don't provide it, Composer will ask for your token when needed.
`machine_name` is used by Virtualbox and should be unique in your system. I.e. you can't have two `vagrant-project` virtual machines.
`databases` are checked on each vagrant startup. The script will automatically create database and mysql user with empty password for accessing the new database. Already existing databases will be skipped.
There's also `root` MySQL user with empty password that can access all databases.
## Adding URLs
Just create new folder inside your projects root folder and `vagrant halt && vagrant up` (to run `hostmanager` provision) inside `vagrant-lemp` folder.
## NGINX configs
Configs are automatically created at each start of Vagrant and are stored in `./nginx/sites/*.conf` files. One file per each project folder. You can safely edit those files, script won't overwrite them (but will recreate configs if you delete them).
The template for those files is `./config/nginx-project.template.conf`. You can edit it to suit your everyday needs.
## xDebug config
xDebug should be up and running on first run. You only need to configure your IDE. Be sure to map your local project directory to directory inside `/app` on remote machine.
In case you need to edit xDebug config, it is located in `./config/xdebug.ini`. Don't forget to restart `php-fpm` after editing.