# Activating PHP Rendering

You can use Whisk to run and display the results of your PHP code live. It is excellent for testing smaller amounts of code before insertion into a large site or testing non-complex pages.

This feature leverages the command line PHP tool.

A file with a .php extension renders as PHP by default. To activate PHP rendering on other/untitled documents, simply change the Mode in the Options section of the Tools Inspector to PHP and it will automatically be rendered. It can also be activated from the main menu via Preview > Mode > PHP.

Change the mode to PHP in the Tools Inspector
Change the mode to PHP in the Tools Inspector

The PHP editing mode can also be set for all new documents by selecting it and then choosing the View > Save Window Layout and Settings menu.


When Whisk is set to refresh instantly, it will report parse errors very often. Therefore setting a delay of 1 second is recommended.

# Viewing HTML Code Output

By default, the PHP mode will render the page in the Web Preview. But it is often useful to look at the HTML Source instead to see what the code is outputting.

The HTML source generated by PHP can be shown by long-pressing the Web Preview toolbar button and choosing HTML Source Code:

View Toolbar Button
View Toolbar Button

It can also be viewed by pressing Command-Shift-Right Arrow, or by choosing the Preview > PHP Output > HTML Source Code menu.

# Configuring PHP

Whisk's General Preferences allows setting the path to the PHP binary. On macOS 12 Monterey and later, a built-in version is used. Prior versions of macOS use the system installation. The path can be modified if you install via homebrew, MAMP, or other means.

# Troubleshooting​

See the PHP Troubleshooting page for more information.