|
@@ -16,15 +16,17 @@
|
|
|
<guid>http://laradock.io/introduction/</guid>
|
|
|
<description>
|
|
|
|
|
|
-<p>Laradock strives to make the PHP development experience easier and faster.</p>
|
|
|
+<p>A full PHP development environment for Docker.</p>
|
|
|
|
|
|
-<p>It contains pre-packaged Docker Images that provides you a wonderful <em>development</em> environment without requiring you to install PHP, NGINX, MySQL, Redis, and any other software on your machines.</p>
|
|
|
+<p>Includes pre-packaged Docker Images, all pre-configured to provide a wonderful PHP development environment.</p>
|
|
|
|
|
|
-<p>Laradock is configured to run Laravel Apps by default, and it can be modified to run all kinds of PHP Apps (Symfony, CodeIgniter, WordPress, Drupal&hellip;).</p>
|
|
|
+<p>Laradock is well known in the Laravel community, as the project started with single focus on running Laravel projects on Docker. Later and due to the large adoption from the PHP community, it started supporting other PHP projects like Symfony, CodeIgniter, WordPress, Drupal&hellip;</p>
|
|
|
+
|
|
|
+<p><img src="https://s19.postimg.org/jblfytw9f/laradock-logo.jpg" alt="" /></p>
|
|
|
|
|
|
<h2 id="quick-overview">Quick Overview</h2>
|
|
|
|
|
|
-<p>Let&rsquo;s see how easy it is to install <code>NGINX</code>, <code>PHP</code>, <code>Composer</code>, <code>MySQL</code>, <code>Redis</code> and <code>beanstalkd</code>:</p>
|
|
|
+<p>Let&rsquo;s see how easy it is to install <code>NGINX</code>, <code>PHP</code>, <code>Composer</code>, <code>MySQL</code>, <code>Redis</code> and <code>Beanstalkd</code>:</p>
|
|
|
|
|
|
<p>1 - Clone Laradock inside your PHP project:</p>
|
|
|
|
|
@@ -53,55 +55,6 @@ QUEUE_HOST=beanstalkd
|
|
|
<pre><code class="language-shell">That's it! enjoy :)
|
|
|
</code></pre>
|
|
|
|
|
|
-<p><a name="what-is-docker"></a></p>
|
|
|
-
|
|
|
-<h2 id="what-is-docker">What is Docker?</h2>
|
|
|
-
|
|
|
-<p><a href="https://www.docker.com">Docker</a> is an open-source project that automates the deployment of applications inside software containers, by providing an additional layer of abstraction and automation of <a href="https://en.wikipedia.org/wiki/Operating-system-level_virtualization">operating-system-level virtualization</a> on Linux, Mac OS and Windows.</p>
|
|
|
-
|
|
|
-<p><a name="why-docker-not-vagrant"></a></p>
|
|
|
-
|
|
|
-<h2 id="why-docker-not-vagrant">Why Docker not Vagrant!?</h2>
|
|
|
-
|
|
|
-<p><a href="https://www.vagrantup.com">Vagrant</a> creates Virtual Machines in minutes while Docker creates Virtual Containers in seconds.</p>
|
|
|
-
|
|
|
-<p>Instead of providing a full Virtual Machines, like you get with Vagrant, Docker provides you <strong>lightweight</strong> Virtual Containers, that share the same kernel and allow to safely execute independent processes.</p>
|
|
|
-
|
|
|
-<p>In addition to the speed, Docker gives tons of features that cannot be achieved with Vagrant.</p>
|
|
|
-
|
|
|
-<p>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).</p>
|
|
|
-
|
|
|
-<p><a name="laradock-vs-homestead"></a></p>
|
|
|
-
|
|
|
-<h2 id="laradock-vs-homestead-for-laravel-developers">Laradock VS Homestead (For Laravel Developers)</h2>
|
|
|
-
|
|
|
-<blockquote>
|
|
|
-<p>Laradock It&rsquo;s like Laravel Homestead but for Docker instead of Vagrant.</p>
|
|
|
-</blockquote>
|
|
|
-
|
|
|
-<p>Laradock and <a href="https://laravel.com/docs/master/homestead">Homestead</a> both give you complete virtual development environments. (Without the need to install and configure every single software on your own Operating System).</p>
|
|
|
-
|
|
|
-<ul>
|
|
|
-<li><p>Homestead is a tool that controls Vagrant for you (using Homestead special commands). And Vagrant manages your Virtual Machine.</p></li>
|
|
|
-
|
|
|
-<li><p>Laradock is a tool that controls Docker for you (using Docker &amp; Docker Compose official commands). And Docker manages your Virtual Containers.</p></li>
|
|
|
-</ul>
|
|
|
-
|
|
|
-<p>Running a virtual container is much faster than running a full virtual Machine. Thus <strong>Laradock is much faster than Homestead</strong>.</p>
|
|
|
-
|
|
|
-<p><a name="Demo"></a></p>
|
|
|
-
|
|
|
-<h2 id="demo-video">Demo Video</h2>
|
|
|
-
|
|
|
-<p>What&rsquo;s better than a <strong>Demo Video</strong>:</p>
|
|
|
-
|
|
|
-<ul>
|
|
|
-<li>Laradock <a href="https://www.youtube.com/watch?v=TQii1jDa96Y">v4.*</a></li>
|
|
|
-<li>Laradock <a href="https://www.youtube.com/watch?v=-DamFMczwDA">v2.*</a></li>
|
|
|
-<li>Laradock <a href="https://www.youtube.com/watch?v=jGkyO6Is_aI">v0.3</a></li>
|
|
|
-<li>Laradock <a href="https://www.youtube.com/watch?v=3YQsHe6oF80">v0.1</a></li>
|
|
|
-</ul>
|
|
|
-
|
|
|
<p><a name="features"></a></p>
|
|
|
|
|
|
<h2 id="features">Features</h2>
|
|
@@ -124,83 +77,72 @@ QUEUE_HOST=beanstalkd
|
|
|
|
|
|
<p><a name="Supported-Containers"></a></p>
|
|
|
|
|
|
-<h2 id="supported-software-containers">Supported Software (Containers)</h2>
|
|
|
+<h2 id="supported-software-images">Supported Software (Images)</h2>
|
|
|
|
|
|
-<ul>
|
|
|
-<li><strong>Database Engines:</strong>
|
|
|
+<p>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.</p>
|
|
|
|
|
|
<ul>
|
|
|
-<li>MySQL</li>
|
|
|
-<li>MariaDB</li>
|
|
|
-<li>MongoDB</li>
|
|
|
-<li>Neo4j</li>
|
|
|
-<li>RethinkDB</li>
|
|
|
-<li>PostgreSQL</li>
|
|
|
-<li>Postgres Postgis</li>
|
|
|
-</ul></li>
|
|
|
+<li><strong>Database Engines:</strong>
|
|
|
+MySQL - MariaDB - MongoDB - Neo4j - RethinkDB - PostgreSQL - Postgres Postgis.</li>
|
|
|
<li><strong>Cache Engines:</strong>
|
|
|
-
|
|
|
-<ul>
|
|
|
-<li>Redis</li>
|
|
|
-<li>Memcached</li>
|
|
|
-<li>Aerospike</li>
|
|
|
-</ul></li>
|
|
|
+Redis - Memcached - Aerospike</li>
|
|
|
<li><strong>PHP Servers:</strong>
|
|
|
-
|
|
|
-<ul>
|
|
|
-<li>NGINX</li>
|
|
|
-<li>Apache2</li>
|
|
|
-<li>Caddy</li>
|
|
|
-</ul></li>
|
|
|
+NGINX - Apache2 - Caddy</li>
|
|
|
<li><strong>PHP Compilers:</strong>
|
|
|
+PHP FPM - HHVM</li>
|
|
|
+<li><strong>Message Queuing:</strong>
|
|
|
+Beanstalkd - Beanstalkd Console - RabbitMQ - RabbitMQ Console</li>
|
|
|
+<li><strong>Tools:</strong>
|
|
|
+PhpMyAdmin - Adminer - PgAdmin - ElasticSearch - Selenium - Certbot - Mailhog - Minio&hellip;</li>
|
|
|
+</ul>
|
|
|
|
|
|
-<ul>
|
|
|
-<li>PHP-FPM</li>
|
|
|
-<li>HHVM</li>
|
|
|
-</ul></li>
|
|
|
-<li><strong>Message Queuing Systems:</strong>
|
|
|
+<p>Laradock introduces the <strong>Workspace</strong> 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.</p>
|
|
|
|
|
|
-<ul>
|
|
|
-<li>Beanstalkd</li>
|
|
|
-<li>Beanstalkd Console</li>
|
|
|
-<li>RabbitMQ</li>
|
|
|
-<li>RabbitMQ Console</li>
|
|
|
-</ul></li>
|
|
|
-<li><strong>Tools:</strong>
|
|
|
+<p><strong>Workspace Image Tools</strong>
|
|
|
+PHP CLI - Composer - Git - Linuxbrew - Node - Gulp - SQLite - xDebug - Envoy - Deployer - Vim - Yarn&hellip;</p>
|
|
|
|
|
|
-<ul>
|
|
|
-<li>PhpMyAdmin</li>
|
|
|
-<li>Adminer</li>
|
|
|
-<li>PgAdmin</li>
|
|
|
-<li>ElasticSearch</li>
|
|
|
-<li>Selenium</li>
|
|
|
-<li>Certbot</li>
|
|
|
-<li>Mailhog</li>
|
|
|
-<li>Minio</li>
|
|
|
-<li>Workspace
|
|
|
-
|
|
|
-<ul>
|
|
|
-<li>PHP7-CLI</li>
|
|
|
-<li>Composer</li>
|
|
|
-<li>Git</li>
|
|
|
-<li>Linuxbrew</li>
|
|
|
-<li>Node</li>
|
|
|
-<li>Gulp</li>
|
|
|
-<li>SQLite</li>
|
|
|
-<li>xDebug</li>
|
|
|
-<li>Envoy</li>
|
|
|
-<li>Deployer</li>
|
|
|
-<li>Vim</li>
|
|
|
-<li>Yarn</li>
|
|
|
-<li>&hellip; Many other supported tools are not documented. (Will be updated soon)</li>
|
|
|
-</ul></li>
|
|
|
-</ul></li>
|
|
|
-</ul>
|
|
|
+<p>You can choose, which tools to install in your workspace container and other containers, from the <code>.env</code> file.</p>
|
|
|
|
|
|
<blockquote>
|
|
|
-<p>If you can&rsquo;t find your Software, build it yourself and add it to this list. Contributions are welcomed :)</p>
|
|
|
+<p>If you modify <code>docker-compose.yml</code>, <code>.env</code> or any <code>dockerfile</code> file, you must re-build your containers, to see those effects in the running instance.</p>
|
|
|
</blockquote>
|
|
|
|
|
|
+<p>If you can&rsquo;t find your Software in the list, build it yourself and sumit it. Contributions are welcomed :)</p>
|
|
|
+
|
|
|
+<p><a name="what-is-docker"></a></p>
|
|
|
+
|
|
|
+<h2 id="what-is-docker">What is Docker?</h2>
|
|
|
+
|
|
|
+<p><a href="https://www.docker.com">Docker</a> is an open-source project that automates the deployment of applications inside software containers, by providing an additional layer of abstraction and automation of <a href="https://en.wikipedia.org/wiki/Operating-system-level_virtualization">operating-system-level virtualization</a> on Linux, Mac OS and Windows.</p>
|
|
|
+
|
|
|
+<p><a name="why-docker-not-vagrant"></a></p>
|
|
|
+
|
|
|
+<h2 id="why-docker-not-vagrant">Why Docker not Vagrant!?</h2>
|
|
|
+
|
|
|
+<p><a href="https://www.vagrantup.com">Vagrant</a> creates Virtual Machines in minutes while Docker creates Virtual Containers in seconds.</p>
|
|
|
+
|
|
|
+<p>Instead of providing a full Virtual Machines, like you get with Vagrant, Docker provides you <strong>lightweight</strong> Virtual Containers, that share the same kernel and allow to safely execute independent processes.</p>
|
|
|
+
|
|
|
+<p>In addition to the speed, Docker gives tons of features that cannot be achieved with Vagrant.</p>
|
|
|
+
|
|
|
+<p>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).</p>
|
|
|
+
|
|
|
+<p><a name="Demo"></a></p>
|
|
|
+
|
|
|
+<h2 id="demo-video">Demo Video</h2>
|
|
|
+
|
|
|
+<p>What&rsquo;s better than a <strong>Demo Video</strong>:</p>
|
|
|
+
|
|
|
+<ul>
|
|
|
+<li>Laradock v5.* (soon or never)</li>
|
|
|
+<li>Laradock <a href="https://www.youtube.com/watch?v=TQii1jDa96Y">v4.*</a></li>
|
|
|
+<li>Laradock <a href="https://www.youtube.com/watch?v=-DamFMczwDA">v2.*</a></li>
|
|
|
+<li>Laradock <a href="https://www.youtube.com/watch?v=jGkyO6Is_aI">v0.3</a></li>
|
|
|
+<li>Laradock <a href="https://www.youtube.com/watch?v=3YQsHe6oF80">v0.1</a></li>
|
|
|
+</ul>
|
|
|
+
|
|
|
<p><a name="Chat"></a></p>
|
|
|
|
|
|
<h2 id="chat-with-us">Chat with us</h2>
|
|
@@ -2411,11 +2353,11 @@ features, by not reporting duplicate issues.</em></p>
|
|
|
|
|
|
<p>Laradock uses <a href="https://gohugo.io/">Hugo</a> as website generator tool, with the <a href="http://themes.gohugo.io/theme/material-docs/">Material Docs theme</a>. You might need to check their docs quickly.</p>
|
|
|
|
|
|
-<p>Go the <code>DOCUMENTATION/_settings/content</code> and search for the markdown file you want to edit</p>
|
|
|
+<p>Go the <code>DOCUMENTATION/content</code> and search for the markdown file you want to edit</p>
|
|
|
|
|
|
<p>Note: Every folder represents a section in the sidebar &ldquo;Menu&rdquo;. And every page and sidebar has a <code>weight</code> number to show it&rsquo;s position in the site.</p>
|
|
|
|
|
|
-<p>To update the sidebar or add a new section to it, you can edit this <code>DOCUMENTATION/_settings/config.toml</code> toml file.</p>
|
|
|
+<p>To update the sidebar or add a new section to it, you can edit this <code>DOCUMENTATION/config.toml</code> toml file.</p>
|
|
|
|
|
|
<blockquote>
|
|
|
<p>The site will be auto-generated in the <code>docs/</code> folder by <a href="https://travis-ci.org/laradock/laradock/">Travis CI</a>.</p>
|
|
@@ -2427,9 +2369,9 @@ features, by not reporting duplicate issues.</em></p>
|
|
|
|
|
|
<ol>
|
|
|
<li>Install <a href="https://gohugo.io/">Hugo</a> on your machine.</li>
|
|
|
-<li>Edit the <code>DOCUMENTATION/_settings/content</code>.</li>
|
|
|
+<li>Edit the <code>DOCUMENTATION/content</code>.</li>
|
|
|
<li>Delete the <code>/docs</code> folder from the root.</li>
|
|
|
-<li>After you finish the editing, go to <code>DOCUMENTATION/_settings/</code> and run the <code>hugo</code> command to generate the HTML docs (inside a new <code>/docs</code> folder).</li>
|
|
|
+<li>After you finish the editing, go to <code>DOCUMENTATION/</code> and run the <code>hugo</code> command to generate the HTML docs (inside a new <code>/docs</code> folder).</li>
|
|
|
</ol>
|
|
|
|
|
|
<h2 id="how-to-support-new-software-add-new-container">How to support new Software (Add new Container)</h2>
|