documentation text updates

This commit is contained in:
Mahmoud Zalt 2019-07-23 22:45:05 +02:00
parent 26184055c5
commit 440d865fc4
4 changed files with 42 additions and 47 deletions

12
.github/README.md vendored
View File

@ -2,7 +2,7 @@
<img src="/.github/home-page-images/laradock-logo.jpg?raw=true" alt="Laradock Logo"/> <img src="/.github/home-page-images/laradock-logo.jpg?raw=true" alt="Laradock Logo"/>
</p> </p>
<p align="center">A Docker PHP development environment that facilitates running PHP Apps on Docker</p> <p align="center">PHP development environment that runs on Docker</p>
<p align="center"> <p align="center">
<a href="https://travis-ci.org/laradock/laradock"><img src="https://travis-ci.org/laradock/laradock.svg?branch=master" alt="Build status"></a> <a href="https://travis-ci.org/laradock/laradock"><img src="https://travis-ci.org/laradock/laradock.svg?branch=master" alt="Build status"></a>
@ -13,7 +13,7 @@
<a href="http://laradock.io/contributing"><img src="https://img.shields.io/badge/contributions-welcome-brightgreen.svg?style=flat" alt="contributions welcome"></a> <a href="http://laradock.io/contributing"><img src="https://img.shields.io/badge/contributions-welcome-brightgreen.svg?style=flat" alt="contributions welcome"></a>
</p> </p>
<h4 align="center" style="color:#7d58c2">Use Docker First And Learn About It Later</h4> <h4 align="center" style="color:#7d58c2">Use Docker First - Then Learn About It Later</h4>
<p align="center"> <p align="center">
<a href="http://zalt.me"><img src="http://forthebadge.com/images/badges/built-by-developers.svg" alt="forthebadge" width="240" ></a> <a href="http://zalt.me"><img src="http://forthebadge.com/images/badges/built-by-developers.svg" alt="forthebadge" width="240" ></a>
@ -44,9 +44,9 @@ For basic sponsorships go to [Open Collective](https://opencollective.com/larado
*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.* *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.*
## Contributors ## People
#### Core contributors: #### Maintainers:
- [Mahmoud Zalt](https://github.com/Mahmoudz) @mahmoudz | [Twitter](https://twitter.com/Mahmoud_Zalt) | [Site](http://zalt.me) - [Mahmoud Zalt](https://github.com/Mahmoudz) @mahmoudz | [Twitter](https://twitter.com/Mahmoud_Zalt) | [Site](http://zalt.me)
- [Bo-Yi Wu](https://github.com/appleboy) @appleboy | [Twitter](https://twitter.com/appleboy) - [Bo-Yi Wu](https://github.com/appleboy) @appleboy | [Twitter](https://twitter.com/appleboy)
- [Philippe Trépanier](https://github.com/philtrep) @philtrep - [Philippe Trépanier](https://github.com/philtrep) @philtrep
@ -59,9 +59,9 @@ For basic sponsorships go to [Open Collective](https://opencollective.com/larado
- [Milan Urukalo](https://github.com/urukalo) @urukalo - [Milan Urukalo](https://github.com/urukalo) @urukalo
- [Vince Chu](https://github.com/vwchu) @vwchu - [Vince Chu](https://github.com/vwchu) @vwchu
- [Huadong Zuo](https://github.com/zuohuadong) @zuohuadong - [Huadong Zuo](https://github.com/zuohuadong) @zuohuadong
- Join us, by submitting 20 useful PR's. - Join us.
#### Awesome contributors: #### Awesome Contributors:
<a href="https://github.com/laradock/laradock/graphs/contributors"><img src="https://opencollective.com/laradock/contributors.svg?width=890" /></a> <a href="https://github.com/laradock/laradock/graphs/contributors"><img src="https://opencollective.com/laradock/contributors.svg?width=890" /></a>

View File

@ -297,6 +297,24 @@ e) set it to `true`
For information on how to configure xDebug with your IDE and work it out, check this [Repository](https://github.com/LarryEitel/laravel-laradock-phpstorm) or follow up on the next section if you use linux and PhpStorm. For information on how to configure xDebug with your IDE and work it out, check this [Repository](https://github.com/LarryEitel/laravel-laradock-phpstorm) or follow up on the next section if you use linux and PhpStorm.
<br>
<a name="Control-xDebug"></a>
## Start/Stop xDebug:
By installing xDebug, you are enabling it to run on startup by default.
To control the behavior of xDebug (in the `php-fpm` Container), you can run the following commands from the Laradock root folder, (at the same prompt where you run docker-compose):
- Stop xDebug from running by default: `.php-fpm/xdebug stop`.
- Start xDebug by default: `.php-fpm/xdebug start`.
- See the status: `.php-fpm/xdebug status`.
Note: If `.php-fpm/xdebug` doesn't execute and gives `Permission Denied` error the problem can be that file `xdebug` doesn't have execution access. This can be fixed by running `chmod` command with desired access permissions.
<br> <br>
<a name="Install-phpdbg"></a> <a name="Install-phpdbg"></a>
## Install phpdbg ## Install phpdbg
@ -321,22 +339,6 @@ PHP_FPM_INSTALL_PHPDBG=true
<br>
<a name="Control-xDebug"></a>
## Start/Stop xDebug:
By installing xDebug, you are enabling it to run on startup by default.
To control the behavior of xDebug (in the `php-fpm` Container), you can run the following commands from the Laradock root folder, (at the same prompt where you run docker-compose):
- Stop xDebug from running by default: `.php-fpm/xdebug stop`.
- Start xDebug by default: `.php-fpm/xdebug start`.
- See the status: `.php-fpm/xdebug status`.
Note: If `.php-fpm/xdebug` doesn't execute and gives `Permission Denied` error the problem can be that file `xdebug` doesn't have execution access. This can be fixed by running `chmod` command with desired access permissions.
<br> <br>
<a name="Install-ionCube-Loader"></a> <a name="Install-ionCube-Loader"></a>
@ -1566,22 +1568,6 @@ Available versions are: 5.5, 5.6, 5.7, 8.0, or latest. See https://store.docker
<br>
<a name="MySQL-access-from-host"></a>
## MySQL access from host
You can forward the MySQL/MariaDB port to your host by making sure these lines are added to the `mysql` or `mariadb` section of the `docker-compose.yml` or in your [environment specific Compose](https://docs.docker.com/compose/extends/) file.
```
ports:
- "3306:3306"
```
<br> <br>
<a name="MySQL-root-access"></a> <a name="MySQL-root-access"></a>
## MySQL root access ## MySQL root access
@ -1682,7 +1668,7 @@ Enabling Global Composer Install during the build for the container allows you t
<br> <br>
<a name="Magento-2-authentication-credentials"></a> <a name="Magento-2-authentication-credentials"></a>
## Magento 2 authentication credential (composer install) ## Add authentication credential for Magento 2
1 - Open the `.env` file 1 - Open the `.env` file

View File

@ -41,7 +41,7 @@ Note: If you are not using Git yet for your project, you can use `git clone` ins
*To keep track of your Laradock changes, between your projects and also keep Laradock updated [check these docs](/documentation/#keep-track-of-your-laradock-changes)* *To keep track of your Laradock changes, between your projects and also keep Laradock updated [check these docs](/documentation/#keep-track-of-your-laradock-changes)*
Your folder structure should look like this: 2 - Make sure your folder structure should look like this:
``` ```
+ project-a + project-a
@ -52,7 +52,7 @@ Your folder structure should look like this:
*(It's important to rename the laradock folders to unique name in each project, if you want to run laradock per project).* *(It's important to rename the laradock folders to unique name in each project, if you want to run laradock per project).*
> **Now jump to the [Usage](#Usage) section.** 3 - Go to the [Usage](#Usage) section.
<a name="A2"></a> <a name="A2"></a>
### A.2) Don't have a PHP project yet: ### A.2) Don't have a PHP project yet:
@ -86,7 +86,7 @@ APP_CODE_PATH_HOST=../project-z/
Make sure to replace `project-z` with your project folder name. Make sure to replace `project-z` with your project folder name.
> **Now jump to the [Usage](#Usage) section.** 3 - Go to the [Usage](#Usage) section.
<a name="B"></a> <a name="B"></a>
@ -127,7 +127,7 @@ You can rename the config files, project folders and domains as you like, just m
If you use Chrome 63 or above for development, don't use `.dev`. [Why?](https://laravel-news.com/chrome-63-now-forces-dev-domains-https). Instead use `.localhost`, `.invalid`, `.test`, or `.example`. If you use Chrome 63 or above for development, don't use `.dev`. [Why?](https://laravel-news.com/chrome-63-now-forces-dev-domains-https). Instead use `.localhost`, `.invalid`, `.test`, or `.example`.
> **Now jump to the [Usage](#Usage) section.** 4 - Go to the [Usage](#Usage) section.
@ -213,7 +213,16 @@ Open your PHP project's `.env` file or whichever configuration file you are read
DB_HOST=mysql DB_HOST=mysql
``` ```
You need to use the Laradock's default DB credentials which can be found in the `.env` file (ex: `MYSQL_USER=`).
Or you can change them and rebuild the container.
*If you want to install Laravel as PHP project, see [How to Install Laravel in a Docker Container](#Install-Laravel).* *If you want to install Laravel as PHP project, see [How to Install Laravel in a Docker Container](#Install-Laravel).*
<br> <br>
5 - Open your browser and visit your localhost address `http://localhost/`. If you followed the multiple projects setup, you can visit `http://project-1.test/` and `http://project-2.test/`. 5 - Open your browser and visit your localhost address.
If you followed the multiple projects setup, you can visit `http://project-1.test/` and `http://project-2.test/`.
[http://localhost:8080](http://localhost:8080)
Make sure you add use the right port number as provided by your running server. Ex: NGINX uses port 8080 by default while Apache2 uses 80.

View File

@ -5,9 +5,9 @@ weight: 1
--- ---
## Use Docker First - Then Learn About It Later
Laradock is a PHP development environment that runs on Docker.
A full PHP development environment for Docker.
Supports a variety of useful Docker Images, pre-configured to provide a wonderful PHP development environment. Supports a variety of useful Docker Images, pre-configured to provide a wonderful PHP development environment.
@ -175,7 +175,7 @@ That's it! enjoy :)
- Web IDE - Web IDE
- **Miscellaneous:** - **Miscellaneous:**
- Workspace: *(Laradock container that includes a rich set of pre-configured useful tools)* - Workspace *(Laradock container that includes a rich set of pre-configured useful tools)*
- `PHP CLI` - `PHP CLI`
- `Composer` - `Composer`
- `Git` - `Git`