|
1 | 1 | --- |
2 | | -title: Documentation |
| 2 | +title: 3. Documentation |
3 | 3 | type: index |
4 | 4 | weight: 3 |
5 | 5 | --- |
@@ -320,21 +320,6 @@ PHP_FPM_INSTALL_PHPDBG=true |
320 | 320 | ``` |
321 | 321 |
|
322 | 322 |
|
323 | | -<a name="Setup remote debugging for PhpStorm on Linux"></a> |
324 | | -## Setup remote debugging for PhpStorm on Linux |
325 | | - |
326 | | - - Make sure you have followed the steps above in the [Install Xdebug section](#install-xdebug). |
327 | | - |
328 | | - - Make sure Xdebug accepts connections and listens on port 9000. (Should be default configuration). |
329 | | - |
330 | | -. |
331 | | - |
332 | | - - Create a server with name `laradock` (matches **PHP_IDE_CONFIG** key in environment file) and make sure to map project root path with server correctly. |
333 | | - |
334 | | -. |
335 | | - |
336 | | - - Start listening for debug connections, place a breakpoint and you are good to go ! |
337 | | - |
338 | 323 |
|
339 | 324 | <br> |
340 | 325 | <a name="Control-xDebug"></a> |
@@ -2029,22 +2014,6 @@ Remote debug Laravel web and phpunit tests. |
2029 | 2014 |
|
2030 | 2015 |
|
2031 | 2016 |
|
2032 | | -<br> |
2033 | | -<a name="upgrading-laradock"></a> |
2034 | | -## Upgrading Laradock |
2035 | | - |
2036 | | -Moving from Docker Toolbox (VirtualBox) to Docker Native (for Mac/Windows). Requires upgrading Laradock from v3.* to v4.*: |
2037 | | - |
2038 | | -1. Stop the docker VM `docker-machine stop {default}` |
2039 | | -2. Install Docker for [Mac](https://docs.docker.com/docker-for-mac/) or [Windows](https://docs.docker.com/docker-for-windows/). |
2040 | | -3. Upgrade Laradock to `v4.*.*` (`git pull origin master`) |
2041 | | -4. Use Laradock as you used to do: `docker-compose up -d nginx mysql`. |
2042 | | - |
2043 | | -**Note:** If you face any problem with the last step above: rebuild all your containers |
2044 | | -`docker-compose build --no-cache` |
2045 | | -"Warning Containers Data might be lost!" |
2046 | | - |
2047 | | - |
2048 | 2017 |
|
2049 | 2018 |
|
2050 | 2019 |
|
@@ -2212,126 +2181,17 @@ docker-compose up ... |
2212 | 2181 |
|
2213 | 2182 |
|
2214 | 2183 |
|
2215 | | - |
2216 | | - |
2217 | | - |
2218 | | -<br> |
2219 | | -<a name="Common-Problems"></a> |
2220 | | -## Common Problems |
2221 | | - |
2222 | | -*Here's a list of the common problems you might face, and the possible solutions.* |
2223 | | - |
2224 | | - |
2225 | | - |
2226 | | - |
2227 | | - |
2228 | | - |
2229 | | -<br> |
2230 | | -## I see a blank (white) page instead of the Laravel 'Welcome' page! |
2231 | | - |
2232 | | -Run the following command from the Laravel root directory: |
2233 | | - |
2234 | | -```bash |
2235 | | -sudo chmod -R 777 storage bootstrap/cache |
2236 | | -``` |
2237 | | - |
2238 | | - |
2239 | | - |
2240 | | - |
2241 | | - |
2242 | | - |
2243 | | -<br> |
2244 | | -## I see "Welcome to nginx" instead of the Laravel App! |
2245 | | - |
2246 | | -Use `http://127.0.0.1` instead of `http://localhost` in your browser. |
2247 | | - |
2248 | | - |
2249 | | - |
2250 | | - |
2251 | | - |
2252 | | - |
2253 | | -<br> |
2254 | | -## I see an error message containing `address already in use` or `port is already allocated` |
2255 | | - |
2256 | | -Make sure the ports for the services that you are trying to run (22, 80, 443, 3306, etc.) are not being used already by other programs on the host, such as a built in `apache`/`httpd` service or other development tools you have installed. |
2257 | | - |
2258 | | - |
2259 | | - |
2260 | | - |
2261 | | - |
2262 | | - |
2263 | | -<br> |
2264 | | -## I get NGINX error 404 Not Found on Windows. |
2265 | | - |
2266 | | -1. Go to docker Settings on your Windows machine. |
2267 | | -2. Click on the `Shared Drives` tab and check the drive that contains your project files. |
2268 | | -3. Enter your windows username and password. |
2269 | | -4. Go to the `reset` tab and click restart docker. |
2270 | | - |
2271 | | - |
2272 | | - |
2273 | | - |
2274 | | - |
2275 | | - |
2276 | | -<br> |
2277 | | -## The time in my services does not match the current time |
2278 | | - |
2279 | | -1. Make sure you've [changed the timezone](#Change-the-timezone). |
2280 | | -2. Stop and rebuild the containers (`docker-compose up -d --build <services>`) |
2281 | | - |
2282 | | - |
2283 | | - |
2284 | | - |
2285 | | - |
2286 | | - |
2287 | | -<br> |
2288 | | -## I get MySQL connection refused |
2289 | | - |
2290 | | -This error sometimes happens because your Laravel application isn't running on the container localhost IP (Which is 127.0.0.1). Steps to fix it: |
2291 | | - |
2292 | | -* Option A |
2293 | | - 1. Check your running Laravel application IP by dumping `Request::ip()` variable using `dd(Request::ip())` anywhere on your application. The result is the IP of your Laravel container. |
2294 | | - 2. Change the `DB_HOST` variable on env with the IP that you received from previous step. |
2295 | | -* Option B |
2296 | | - 1. Change the `DB_HOST` value to the same name as the MySQL docker container. The Laradock docker-compose file currently has this as `mysql` |
2297 | | - |
2298 | | -## I get stuck when building nginx on `fetch http://mirrors.aliyun.com/alpine/v3.5/main/x86_64/APKINDEX.tar.gz` |
2299 | | - |
2300 | | -As stated on [#749](https://github.com/laradock/laradock/issues/749#issuecomment-419652646), Already fixed，just set `CHANGE_SOURCE` to false. |
2301 | | - |
2302 | | -## Custom composer repo packagist url and npm registry url |
2303 | | - |
2304 | | -In China, the origin source of composer and npm is very slow. You can add `WORKSPACE_NPM_REGISTRY` and `WORKSPACE_COMPOSER_REPO_PACKAGIST` config in `.env` to use your custom source. |
2305 | | - |
2306 | | -Example: |
2307 | | -```bash |
2308 | | -WORKSPACE_NPM_REGISTRY=https://registry.npm.taobao.org |
2309 | | -WORKSPACE_COMPOSER_REPO_PACKAGIST=https://packagist.phpcomposer.com |
2310 | | -``` |
2311 | | - |
2312 | 2184 | <br> |
| 2185 | +<a name="upgrade-laradock"></a> |
| 2186 | +## Upgrade Laradock |
2313 | 2187 |
|
2314 | | -## I get `Module build failed: Error: write EPIPE` while compiling react application |
2315 | | - |
2316 | | -When you run `npm build` or `yarn dev` building a react application using webpack with elixir you may receive a `Error: write EPIPE` while processing .jpg images. |
2317 | | - |
2318 | | -This is caused of an outdated library for processing **.jpg files** in ubuntu 16.04. |
2319 | | - |
2320 | | -To fix the problem you can follow those steps |
2321 | | - |
2322 | | -1 - Open the `.env`. |
2323 | | - |
2324 | | -2 - Search for `WORKSPACE_INSTALL_LIBPNG` or add the key if missing. |
2325 | | - |
2326 | | -3 - Set the value to true: |
2327 | | - |
2328 | | -```dotenv |
2329 | | -WORKSPACE_INSTALL_LIBPNG=true |
2330 | | -``` |
2331 | | - |
2332 | | -4 - Finally rebuild the workspace image |
| 2188 | +Moving from Docker Toolbox (VirtualBox) to Docker Native (for Mac/Windows). Requires upgrading Laradock from v3.* to v4.*: |
2333 | 2189 |
|
2334 | | -```bash |
2335 | | -docker-compose build workspace |
2336 | | -``` |
| 2190 | +1. Stop the docker VM `docker-machine stop {default}` |
| 2191 | +2. Install Docker for [Mac](https://docs.docker.com/docker-for-mac/) or [Windows](https://docs.docker.com/docker-for-windows/). |
| 2192 | +3. Upgrade Laradock to `v4.*.*` (`git pull origin master`) |
| 2193 | +4. Use Laradock as you used to do: `docker-compose up -d nginx mysql`. |
2337 | 2194 |
|
| 2195 | +**Note:** If you face any problem with the last step above: rebuild all your containers |
| 2196 | +`docker-compose build --no-cache` |
| 2197 | +"Warning Containers Data might be lost!" |
0 commit comments