PHP Sniffer & Beautifier Docker

This extension is a fork of PHP Sniffer & Beautifier for VS Code

This plugin for Visual Studio Code allows you to view linting errors and run code fixes from phpcs & phpcbf running in a Docker container within your local VS Code editor.

This is useful for cases where you are developing in a Docker container but do not want to run / are not able to run a Dev Container.

This extension maintains compatibility with PHP Sniffer & Beautifier for VS Code with some code tweaks to extend it to work with Docker.

Quick start

• Add a .vscode directory to your project if it does not already exist
• Create a settings.json file within your .vscode directory or append extension settings if the file already exists
• Insert the following settings:

{
	"phpsab.docker.dockerEnabled": true,
	"phpsab.docker.dockerContainer": "<container_name or container_id of running Docker container>",
	"phpsab.docker.dockerWorkspaceRoot": "<path to your projects root directory within the Docker container>"
}

For example, if you are developing a WordPress plugin at /home/<user>/Projects/MyPlugin on your local system which is mounted to /var/www/html/wp-content/plugins/MyPlugin inside a Docker container named wordpress you could use the following settings:

{
	"phpsab.docker.dockerEnabled": true,
	"phpsab.docker.dockerContainer": "wordpress",
	"phpsab.docker.dockerWorkspaceRoot": "/var/www/html/wp-content/plugins/MyPlugin"
}

Docker settings

To enable linting from within a Docker container the extension provides a number of settings that need to be added to your settings.json file within the .vscode directory of your VS Code workspace.

This extension assumes that you are intending to run phpcs & phpcbf within the Docker container of the project you are currently developing in.

Under the hood, all phpcs and phpcbf commands are run within the Docker container listed in the phpsab.docker.dockerContainer setting and then forwarded to your local files.

As such, it is recommended that these are added in each project that you work on in a .vscode directory rather than as a global setting.

For documentation on adding a setting.json file to your Workspace using the .vscode directory see the User and Workspace Settings docs for VS Code.

PHP Sniffer & Beautifier Settings

Setting properties have been tweaked for this plugin. See changed property names for PHP Sniffer & Beautifier Docker below.

For full documentation, please see the docs in the original PHP Sniffer & Beautifier for VS Code extension repo.

Acknowledgements

This extension is based off of the PHP Sniffer & Beautifier for VS Code extension.