584392bd92
There was a edge case with the declaration of the `lsp` layer in `layers.el` files. The `hy` layer depends on the `python` layer which in turn depends on the `lsp` layer if and only if the `python-backend` layer variable is set to `lsp`. When the `hy` layer was declared first then it declares the `python` layer without its layer variables, thus the `lsp` layer was not declared because the `python-backend` variable was not set. The fix is to gather all the layer dependencies and resolve them only after all the used layers have been declared. * new function `configuration-layer/declare-layer-dependencies` * replace all calls to `configuration-layer/declare-layer` by the new function except for distribution layers (we declare layer dependencies right away in distribution layers) |
||
|---|---|---|
| .. | ||
| img | ||
| config.el | ||
| funcs.el | ||
| layers.el | ||
| packages.el | ||
| README.org | ||
PHP layer
Description
This layer adds PHP language support to Spacemacs.
Features:
- Edit PHP files using php-mode
- Edit Drupal files
- Complete and jump to define with company-php
- Run tests with PHPUnit
- Reformat code with PHP CBF
- Support for the Language Server Protocol (experimental)
The gtags layer is recommended to benefit from better eldoc and
helm-gtags.
Install
Layer
To use this configuration layer, add it to your ~/.spacemacs. You will need to
add php to the existing dotspacemacs-configuration-layers list in this
file.
Backends
For php you have the choice between a set of possible LSP backends with different setup instructions and different capabilities.
Note that you'll need to use the lsp layer to enable these backends.
intelephense
This is the recommended LSP server solution. To activate it set the
layer variable php-backend:
(php :variables php-backend 'lsp)and install the npm server with:
npm install -g intelephenseYou can find further information on the project's website and GitHub page.
php-language-server
This is an alternative LSP server implementation working on PHP basis rather than nodejs.
To activate it set the layer variable php-backend like for the intelephense backend and
install the server via composer:
composer require felixfbecker/language-server
composer run-script --working-dir=vendor/felixfbecker/language-server parse-stubsYou can find further information on the project's GitHub page.
ac-php-core
This is a non server solution working entirely from an elisp package. This requires no installation of external services but also delivers the least amount of IDE like integrations with spacemacs.
To activate it just don't set the variable php-backend in your dotfile.
Remember that additional setup instructions are necessary on a per
project basis which you can find below.
Setup
Because of the way that the ac-php-core package works, there are a couple of simple initialization tasks which must occur to get the completion working as it should. On any new project make sure to perform the following initialization tasks:
-
Run the following
cd /root/of/project touch .ac-php-conf.json - Inside of spacemacs run: = ac-php-remake-tags =
The .ac-php-conf.json file is required to enable auto-completion. When you run
ac-php-remake-tags and your .ac-php-conf.json file is empty the default configuration
will be used and inserted in the file.
If your project contains the following files at the root folder:
.projectilevendor/autoload.php
the necessary configuration file (.ac-php-conf.json) will be created automatically
if it does not exist.
Key bindings
| Key binding | Description |
|---|---|
SPC m g g |
jump to define at point |
C-t |
jump back |