Troubleshooting Debian Linux Installations

Common issues with Linux installations include not having a new enough version of PHP and not having Composer available.

Step 1: Check your PHP version

You can check your PHP version with php -v

If you have a PHP version less than 5.6, you will need to update it to at least 5.6, you can do so with the following commands:

sudo apt-get install software-properties-common

sudo add-apt-repository ppa:ondrej/php5-5.6

Step 2: Check PHP School's bin directory is available in $PATH

After installing a workshop using the workshop manager you may find it's not available to run immediately. If this happens the simplest remedy is to make sure PHP School's workshop bin directory is available in the $PATH environment variable.

You can check this with workshop-manager verify which will also provide the relevant details on how to resolve the issue.

To learn more about the $PATH environment, click here.

Troubleshooting Mac OSX Installations

Common issues with Mac OSX installations include not having a new enough version of PHP and not having Composer available.

Step 1: Check your PHP version

You can check your PHP version with php -v

If you have a PHP version less than 5.6, you will need to update it to at least 5.6, you can do so with the following commands:

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

brew tap homebrew/dupes

brew tap homebrew/homebrew-php

brew install php56

export PATH="$(brew --prefix php56)/bin:$PATH"

Step 2: Check PHP School's bin directory is available in $PATH

After installing a workshop using the workshop manager you may find it's not available to run immediately. If this happens the simplest remedy is to make sure PHP School's workshop bin directory is available in the $PATH environment variable.

You can check this with workshop-manager verify which will also provide the relevant details on how to resolve the issue.

To learn more about the $PATH environment, click here.

Troubleshooting Windows Installations

Windows is a difficult system to cater for in the PHP world. Unfortunately, it has various differences on the command line and console emulators which PHP unfortunately doesn't support. The best way to get PHP School Workshops running is to install Cygwin + ConEmu. Once the initial setup of these are complete, the process of installing workshops is the same as Linux and Mac OSX operating systems.

Step 1: Check if Cygwin is installed

If not, follow the instructions below:

  1. Head on over to https://cygwin.com/install.html and grab the latest installer for your system, 32-bit or 64-bit.
  2. Run the installer and chose the default values until the package selection point.
  3. Ensure you choose to install ALL PHP packages. We also recommend installing GIT and VIM to complete your CLI experience.
  4. Complete the installation.

Step 2: Check if ConEmu is installed

  1. Grab the installer from https://conemu.github.io/.
  2. Run the installer and open ConEmu.
  3. Select Cygwin Bash

Step 3: Check PHP School's bin directory is available in $PATH

After installing a workshop using the workshop manager you may find it's not available to run immediately. If this happens the simplest remedy is to make sure PHP School's workshop bin directory is available in the $PATH environment variable.

You can check this with workshop-manager verify which will also provide the relevant details on how to resolve the issue.

To learn more about the $PATH environment, click here.