209 lines
7.7 KiB
Markdown
209 lines
7.7 KiB
Markdown
---
|
||
title: Introduction
|
||
type: index
|
||
weight: 1
|
||
---
|
||
|
||
|
||
|
||
|
||
A full PHP development environment for Docker.
|
||
|
||
Includes a lot of useful Docker Images, all pre-configured to provide a wonderful PHP development environment.
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
<a name="sponsors"></a>
|
||
## Sponsors
|
||
|
||
<a href="https://opencollective.com/laradock/sponsor/0/website" target="_blank"><img src="https://opencollective.com/laradock/sponsor/0/avatar.svg"></a>
|
||
<a href="https://opencollective.com/laradock/sponsor/1/website" target="_blank"><img src="https://opencollective.com/laradock/sponsor/1/avatar.svg"></a>
|
||
<a href="https://opencollective.com/laradock/sponsor/2/website" target="_blank"><img src="https://opencollective.com/laradock/sponsor/2/avatar.svg"></a>
|
||
<a href="https://opencollective.com/laradock/sponsor/3/website" target="_blank"><img src="https://opencollective.com/laradock/sponsor/3/avatar.svg"></a>
|
||
<a href="https://opencollective.com/laradock/sponsor/4/website" target="_blank"><img src="https://opencollective.com/laradock/sponsor/4/avatar.svg"></a>
|
||
<a href="https://opencollective.com/laradock/sponsor/5/website" target="_blank"><img src="https://opencollective.com/laradock/sponsor/5/avatar.svg"></a>
|
||
<a href="https://opencollective.com/laradock/sponsor/6/website" target="_blank"><img src="https://opencollective.com/laradock/sponsor/6/avatar.svg"></a>
|
||
<a href="https://opencollective.com/laradock/sponsor/7/website" target="_blank"><img src="https://opencollective.com/laradock/sponsor/7/avatar.svg"></a>
|
||
|
||
For basic sponsorships go to [Open Collective](https://opencollective.com/laradock#sponsor), for golden sponsorships contact <a href = "mailto: support@laradock.io">support@laradock.io</a>.
|
||
<br>
|
||
Your logo will show up on the [github repository](https://github.com/laradock/laradock/) index page and the [documentation](http://laradock.io/) main page, with a link to your website.
|
||
|
||
## Quick Overview
|
||
|
||
Let's see how easy it is to install `NGINX`, `PHP`, `Composer`, `MySQL`, `Redis` and `Beanstalkd`:
|
||
|
||
1 - Clone Laradock inside your PHP project:
|
||
|
||
```shell
|
||
git clone https://github.com/Laradock/laradock.git
|
||
```
|
||
|
||
2 - Enter the laradock folder and rename `env-example` to `.env`.
|
||
|
||
```shell
|
||
cp env-example .env
|
||
```
|
||
|
||
3 - Run your containers:
|
||
|
||
```shell
|
||
docker-compose up -d nginx mysql phpmyadmin redis workspace
|
||
```
|
||
|
||
4 - Open your project's `.env` file and set the following:
|
||
|
||
```shell
|
||
DB_HOST=mysql
|
||
REDIS_HOST=redis
|
||
QUEUE_HOST=beanstalkd
|
||
```
|
||
|
||
5 - Open your browser and visit localhost: `http://localhost`.
|
||
|
||
```shell
|
||
That's it! enjoy :)
|
||
```
|
||
|
||
|
||
|
||
|
||
<a name="features"></a>
|
||
## Features
|
||
|
||
- Easy switch between PHP versions: 7.3, 7.2, 7.1, 5.6...
|
||
- Choose your favorite database engine: MySQL, Postgres, MariaDB...
|
||
- Run your own combination of software: Memcached, HHVM, Beanstalkd...
|
||
- Every software runs on a separate container: PHP-FPM, NGINX, PHP-CLI...
|
||
- Easy to customize any container, with simple edit to the `Dockerfile`.
|
||
- All Images extends from an official base Image. (Trusted base Images).
|
||
- Pre-configured NGINX to host any code at your root directory.
|
||
- Can use Laradock per project, or single Laradock for all projects.
|
||
- Easy to install/remove software's in Containers using environment variables.
|
||
- Clean and well structured Dockerfiles (`Dockerfile`).
|
||
- Latest version of the Docker Compose file (`docker-compose`).
|
||
- Everything is visible and editable.
|
||
- Fast Images Builds.
|
||
- More to come every week..
|
||
|
||
|
||
|
||
|
||
<a name="Supported-Containers"></a>
|
||
## Supported Software (Images)
|
||
|
||
In adhering to the separation of concerns principle as promoted by Docker, Laradock runs each software on its own Container.
|
||
You can turn On/Off as many instances of as any container without worrying about the configurations, everything works like a charm.
|
||
|
||
- **Database Engines:**
|
||
MySQL - MariaDB - Percona - MongoDB - Neo4j - RethinkDB - MSSQL - PostgreSQL - Postgres-PostGIS.
|
||
- **Database Management:**
|
||
PhpMyAdmin - Adminer - PgAdmin
|
||
- **Cache Engines:**
|
||
Redis - Memcached - Aerospike
|
||
- **PHP Servers:**
|
||
NGINX - Apache2 - Caddy
|
||
- **PHP Compilers:**
|
||
PHP FPM - HHVM
|
||
- **Message Queueing:**
|
||
Beanstalkd - RabbitMQ - PHP Worker
|
||
- **Queueing Management:**
|
||
Beanstalkd Console - RabbitMQ Console
|
||
- **Random Tools:**
|
||
Mailu - HAProxy - Certbot - Blackfire - Selenium - Jenkins - ElasticSearch - Kibana - Grafana - Gitlab - Mailhog - MailDev - Minio - Varnish - Swoole - NetData - Portainer - Laravel Echo - Phalcon...
|
||
|
||
Laradock introduces the **Workspace** Image, as a development environment.
|
||
It contains a rich set of helpful tools, all pre-configured to work and integrate with almost any combination of Containers and tools you may choose.
|
||
|
||
**Workspace Image Tools**
|
||
PHP CLI - Composer - Git - Linuxbrew - Node - V8JS - Gulp - SQLite - xDebug - Envoy - Deployer - Vim - Yarn - SOAP - Drush - WP-CLI...
|
||
|
||
You can choose, which tools to install in your workspace container and other containers, from the `.env` file.
|
||
|
||
|
||
> If you modify `docker-compose.yml`, `.env` or any `dockerfile` file, you must re-build your containers, to see those effects in the running instance.
|
||
|
||
|
||
|
||
If you can't find your Software in the list, build it yourself and submit it. Contributions are welcomed :)
|
||
|
||
|
||
|
||
<a name="what-is-docker"></a>
|
||
## What is Docker?
|
||
|
||
[Docker](https://www.docker.com) is an open platform for developing, shipping, and running applications.
|
||
Docker enables you to separate your applications from your infrastructure so you can deliver software quickly.
|
||
With Docker, you can manage your infrastructure in the same ways you manage your applications.
|
||
By taking advantage of Docker’s methodologies for shipping, testing, and deploying code quickly, you can significantly reduce the delay between writing code and running it in production.
|
||
|
||
|
||
|
||
|
||
|
||
<a name="why-docker-not-vagrant"></a>
|
||
## Why Docker not Vagrant!?
|
||
|
||
[Vagrant](https://www.vagrantup.com) creates Virtual Machines in minutes while Docker creates Virtual Containers in seconds.
|
||
|
||
Instead of providing a full Virtual Machines, like you get with Vagrant, Docker provides you **lightweight** Virtual Containers, that share the same kernel and allow to safely execute independent processes.
|
||
|
||
In addition to the speed, Docker gives tons of features that cannot be achieved with Vagrant.
|
||
|
||
Most importantly Docker can run on Development and on Production (same environment everywhere). While Vagrant is designed for Development only, (so you have to re-provision your server on Production every time).
|
||
|
||
|
||
|
||
|
||
|
||
|
||
<a name="Demo"></a>
|
||
## Demo Video
|
||
|
||
What's better than a **Demo Video**:
|
||
|
||
- Laradock v5.* (should be next!)
|
||
- Laradock [v4.*](https://www.youtube.com/watch?v=TQii1jDa96Y)
|
||
- Laradock [v2.*](https://www.youtube.com/watch?v=-DamFMczwDA)
|
||
- Laradock [v0.3](https://www.youtube.com/watch?v=jGkyO6Is_aI)
|
||
- Laradock [v0.1](https://www.youtube.com/watch?v=3YQsHe6oF80)
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
<a name="Chat"></a>
|
||
## Chat with us
|
||
|
||
You are welcome to join our chat room on Gitter.
|
||
|
||
[](https://gitter.im/Laradock/laradock?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge)
|
||
|
||
|
||
|
||
|
||
|
||
<a name="Donations"></a>
|
||
## Donations
|
||
|
||
> Help keeping the project development going, by [contributing](http://laradock.io/contributing) or donating a little.
|
||
> Thanks in advance.
|
||
|
||
Donate directly via [Paypal](https://www.paypal.me/mzalt)
|
||
|
||
[](https://www.paypal.me/mzalt)
|
||
|
||
or become a backer on [Open Collective](https://opencollective.com/laradock#backer)
|
||
|
||
<a href="https://opencollective.com/laradock#backers" target="_blank"><img src="https://opencollective.com/laradock/backers.svg?width=890"></a>
|
||
|
||
or show your support via [Beerpay](https://beerpay.io/laradock/laradock)
|
||
|
||
[](https://beerpay.io/laradock/laradock)
|