Skip to content

Latest commit

 

History

History
145 lines (92 loc) · 5.93 KB

faqs.md

File metadata and controls

145 lines (92 loc) · 5.93 KB

FAQs ❓

How do I setup/run Crons?

Each version of PHP can have it's own CRON's.

  1. Simply create a file called custom_crontab in the PHP directory of your choice (eg. /php/74/custom_crontab). Add your CRON's to this script.
  2. Rebuild that PHP container: docker-compose build php74-fpm
  3. And start it up: docker-compose up -d

Your CRON entries should look something like this:

* * * * * php /var/www/html/my-wordpress-site/wp-cron.php

The CRON's will only run while your docker containers are running.

"Container Name already in use" error

In some instances a build may fail due to a Container Name already in use error. You can fix this by following the "update" instructions above. This will recreate a fresh environment from scratch.

How do I get BrowserSync working from inside a container?

BrowserSync works by proxying a host and auto-refreshing the browser when a file was updated. When run from within a container, it needs to proxy the PHP site through the apache container (to get the same result that you see).

We have 2 options for this.

1. Adjust your site's config

We have a (wildcard) DNS redirect setup at *.lde.pvtl.io which points to the apache container's IP address. This is for convenience, so that our docker container can use that hostname to find the IP. Simply adjust your BrowserSync config to use this hostname:

  1. BrowserSync config: Instead of using the hostname <SITE NAME>.pub.localhost, use <SITE NAME>.pub.lde.pvtl.io
  2. (optional) .env: Adjust your site's hostname (usually in .env) to use the same .lde.pvtl.io alternative
    • Primarily relevant in Wordpress sites, because Wordpress will redirect to WP_HOME

2. Manually Define

Alternatively, you can manually define where your host is (i.e. what is the hosts IP?). In our case, the IP is that of the apache container.

  1. docker exec -it php74-fpm bash - SSH into the container where you're running yarn watch from
  2. nano /etc/hosts - Edit the hosts file
    • 192.168.103.1 <THIS SITE URL eg. wp.pub.localhost> - Add the current site's URL, pointing to the apache container
    • You can find the apache containers IP with ping -c 1 apache | awk -F '[()]' '{print $2}' | head -n 1

How do I use HTTPS/SSL for my local containers?

We have a HTTPS container available, that proxies traffic over https (:443) (with a self signed certificate) to/from your localhost port 80 addresses.

By default this container is commented out (as it's not used regularly by everyone). To enable it:

  • Add the container - Uncomment the https container in /docker-compose.yml
  • Rebuild and restart - docker-compose build --pull --no-cache https && docker-compose up -d

Note that Chrome/Edge may require you to enable a feature flag, to access the site with an insecure (self signed) certificate:

  • edge://flags or chrome://flags
  • Enable: Allow invalid certificates for resources loaded from localhost.

How do I use Blackfire?

By default, Blackfire is commented out (as it's not used regularly by everyone). To enable it:

1. Update your environment

  • Update the environment variables (BLACKFIRE_CLIENT_ID etc) in /.env
  • Add the container - Uncomment the blackfire container in /docker-compose.yml
  • Add the PHP module - Uncomment the Blackfire PHP Profiler... block in /php/shared.sh
  • Rebuild and restart - docker-compose down && docker-compose build --pull --no-cache && docker-compose up -d (this will take a while)

2. Profile

Mapping a Custom Hostname to a local site

Let's say you want phpinfo.com to map to a local site. It's as easy as adding a new conf file to apache/sites then rebuilding (docker-compose build apache) and starting (docker-compose up -d). The file would looking something like this:

DocumentRoot /var/www/html
DirectoryIndex index.html index.php
ServerAdmin [email protected]

<VirtualHost *:*>
    ServerName phpinfo.com
    ServerAlias phpinfo.com

    UseCanonicalName Off
    VirtualDocumentRoot /var/www/html/info

    <FilesMatch "\.php$">
      SetHandler proxy:fcgi://php74-fpm:9000
    </FilesMatch>
</VirtualHost>

Note that apache will load the conf files in alphabetical order. Because our zzzlocalhost.conf has a "catch all", any of our custom conf files, must be named alphabetically before zzzlocalhost.conf (that's why we prefixed the name with zzz)

Changing your MySQL Root password

If data already exists in your MySQL data store (eg. you've started the MySQL container in the past), simply changing the .env MYSQL_ROOT_PASSWORD will not change the password. Instead, you need to follow the following steps:

  • Update MYSQL_ROOT_PASSWORD in .env, to your new password
  • Build, start and exec into your MySQL container: docker-compose exec mysql bash
  • Login to MySQL: mysql -u root -p
  • Execute the following:
use mysql;
update user set authentication_string=password('YOUR_NEW_PASSWORD_HERE') where user='root';
flush privileges;
quit;

Dev-In command

A handy command group to exec into your PHP containers, switch to the "www-data" user and then change directory to your current working directory. Run this command group from your project directory.

args="cd /var/www/html/${PWD##*/}; su www-data -s /bin/bash" && cd ~/<projects-directory>/docker-dev && docker-compose exec <php-container-name> bash -c "$args"

Additionally, you could save this command group to a script file (.sh), and add an alias to your ~/.bashrc file to execute the script

alias devin="sh ~/path/to/script/file/<script-file>.sh"

This allows you to run "devin" from your project folder to execute the command group