Table of Contents

PHP layer

Table of ContentsClose


1 Description

This layer adds PHP language support to Spacemacs.

1.1 Features:

The gtags layer is recommended to benefit from better eldoc and helm-gtags.

2 Install

2.1 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.

2.2 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.

2.2.1 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 intelephense

You can find further information on the project's website and GitHub page.

2.2.2 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-stubs

You can find further information on the project's GitHub page.

2.2.3 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.

  1. 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:

    1. Run the following

      cd /root/of/project
      touch .ac-php-conf.json
    2. 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:

    1. .projectile
    2. vendor/autoload.php

    the necessary configuration file (.ac-php-conf.json) will be created automatically if it does not exist.

3 Key bindings

Key binding Description
SPC m g g jump to define at point
C-t jump back

Author: root

Created: 2019-11-10 Sun 14:17