doomemacs/modules/lang/php/README.org

lang/php

• Description
  • Maintainers
  • Module Flags
  • Plugins
• Prerequisites
  • PHP
    • MacOS
    • Arch Linux
    • openSUSE
  • Dependencies
• Features
• Configuration
• Troubleshooting

Description

This module adds support for PHP 5.3+ (including PHP7).

• ctags-based code completion (company-php and phpctags)
• eldoc support (ac-php and php-extras)
• REPL (php-boris)
• Code refactoring commands (php-refactor-mode)
• Unit-test commands (phpunit)
• Support for laravel and composer projects (with project-specific snippets)
• File templates
• Snippets

PHP was the first programming language I got paid to code in, back in the Cretaceous period (2003). My sincerest apologies go out to all the programmers who inherited my earliest PHP work. I know you're out there, writhing in your straitjackets.

Save a programmer today. Stop a friend from choosing PHP as their first language.

Maintainers

This module has no dedicated maintainers.

Module Flags

• +hack Add support for the Hack dialect of PHP by Facebook.
• +lsp Enable LSP support through phpactor. Requires the :tools lsp module and the phpactor server to be installed on your system.

Plugins

• async
• php-boris
• php-extras
• php-mode
• php-refactor-mode
• phpunit

• +hack

  • hack-mode

• +lsp

  • phpactor
  • company-phpactor

• :editor format

  • php-cs-fixer

Prerequisites

PHP

To get started with PHP, you'll need php (5.3+) and composer:

MacOS

PHP 5.5 comes prepackaged with newer versions of MacOS. These instructions are provided for reference:

brew tap homebrew/homebrew-php
brew install php71  # or php53, php54, php55
brew install composer

Arch Linux

sudo pacman --needed --noconfirm -S php composer  # or php53, php54, php55

openSUSE

sudo zypper install php-composer

Dependencies

The features in this module optionally depend on the following php packages:

• boris (REPL)
• phpctags (better code completion)
• phpunit (unit test commands)

composer global require \
    d11wtq/boris \
    phpunit/phpunit \
    techlivezheng/phpctags

Ensure that \~/.composer/vendor/bin is in PATH:

# place this in your profile file, like ~/.bash_profile or ~/.zshenv
export PATH="~/.composer/vendor/bin:$PATH"

TODO Features

TODO Configuration

TODO Troubleshooting