PHP Mode for GNU Emacs

GNU EmacsでのPHPコーディングを支援するメジャーモードの開発プロジェクトです。これまで、以下の人々の作業をもとにフォークされました。

Turadg Aleahmad (Original Author)
Aaron S. Hawley
Lennart Borgman
Eric James Michael Ritz
Syohei Yoshida

リストアップされたすべての貢献者たちも同様にPHPモードを改善しました。

現在のメンテナ：

USAMI Kenta (@zonuexe)

PHP ModeのGitHubプロジェクトにissueを作成してバグ報告や機能リクエストを送ってください。あるいはPHP suiteのFeatHubページに機能リクエストを送っても構いません。

インストール

PHP ModeはEmacs 24.3以降で動作します。古いバージョンのEmacsでも動作するかもしれませんが、保証外です。古いバージョンのEmacsのPHPモードを使用することによる問題のバグ報告は積極的に対応しません。現在のサポートポリシーはSupported Versionのページをご覧ください。

(推奨) MELPAからのインストール

GNU Emacs 24以降では、package機能(またはCask)を使ってMELPA/MELPA StableからPHP Modeをインストールできます。

手動でインストール

このプロジェクトを git cline または、php-mode releasesからzip/tarアーカイブをダウンロードして展開してください。

A: `(load php-mode-autoloads.el)` (推奨)

これはパッケージマネージャを利用した場合と同等のパフォーマンスと使いやすさを両立した初期化方法です。

ダウンロードしたコードを展開したディレクトリに移動し、makeコマンドを実行すると、バイトコンパイルおよび php-mode-autoloads.el を生成できます。 init.elからファイルをロードするだけで使用準備は完了です。

;; Put follow code into init.el
(when (file-directory-p "~/path/to/php-mode")
  (load "~/path/to/php-mode/php-mode-autoloads.el"))

;; Any code below is *unnecessary*
;; (require 'php-mode)
;; (add-to-list 'load-path (expand-file-name "~/path/to/php-mode"))
;; (add-to-list 'auto-mode-alist '("\\.php\\'" . php-mode))

B: `(autoload 'php-mode)`

Emacs起動時の僅かな読み込み増加をも削減したい上級ユーザー向けです。

この場合も makeでバイトコンパイルしておくことを推奨します。

;; Put follow code into init.el
(autoload 'php-mode (expand-file-name "~/path/to/php-mode/php-mode") "\
Major mode for editing PHP code.

\\{php-mode-map}

\(fn)" t nil)

(add-to-list 'auto-mode-alist '("\\.\\(?:php\\|phtml\\)\\'" . php-mode))

;; Any code below is *unnecessary*
;; (add-to-list 'load-path (expand-file-name "~/path/to/php-mode"))
;; (require 'php-mode)

C: `(require 'php-mode)` (非推奨)

特定のパスからphp-modeを同期的に読み込みます。 Aの場合と比べて10倍のサイズのコードを読み込むことになり、起動時間の増加幅はCPUとファイスシステムのパフォーマンスに依存します。

(require 'php-mode "~/path/to/php-mode/php-mode")
(add-to-list 'load-path (expand-file-name "~/path/to/php-mode"))

バグを報告する

報告の際には M-x php-mode-debug コマンドを実行して、その出力をバグレポートに含めてください。問題を再現するための手がかりになります。

Settings

個人設定

.emacsファイル(~/.emacs.d/init.el)にPHPモードでの設定を記述できます。

(defun my-php-mode-init ()
  (setq-local show-trailing-whitespace t)
  (setq-local ac-disable-faces '(font-lock-comment-face font-lock-string-face))
  (setq-local page-delimiter "\\_<\\(class\\|function\\|namespace\\)\\_>.+$")

  ;; If you feel phumped and phpcs annoying, invalidate them.
  (when (boundp 'flycheck-disabled-checkers)
    (add-to-list 'flycheck-disabled-checkers 'php-phpmd)
    (add-to-list 'flycheck-disabled-checkers 'php-phpcs)))

(add-hook 'php-mode-hook #'my-php-mode-init)

プロジェクトローカル設定

プロジェクトのトップディレクトリに.dir-locals.elを記述すると、プロジェクト単位の設定を追加することができます。このファイルはユーザー自身のEmacsにインストールされたパッケージに依存するため、バージョン管理の対象に含めないことを推奨します。

((nil
  (php-project-root . git)
  (php-project-coding-style . psr2)))

実験的および作業中の機能

CC Mode, CEDET, EDE, and Semantic

In 2013 Daniel Haxney began rewriting parts of PHP Mode in terms of Emacs' built-in CC Mode. This laid the foundation for incorporating some of the inherit IDE-ish features of Emacs, such as CEDET, EDE, and Semantic. Support for these tools continues to improve thanks to the work of Andrea Turso, Steven Rémot, Joris Steyn, and others. If you wish to test, contribute to, or simply experiment with such features then this thread is a good place to start.

PHP7サポート

PHP7がリリースされました。PHPモードはPHP7からの以下の文法をサポートします。

返り値の型宣言
yield from キーワード
declare(strict_types=1) 宣言

機能

新しいキーワード

現在のPHPモードはトレイト関連のinsteadofなどのPHP5.4で導入された新しいキーワードを構文強調表示します。また、従来のキーワードcloneやdefaultなどもサポートします。

定数

強調表示には公式のPHPマニュアルに記載があるすべてのマジック定数と定義済み定数が含まれます。ただし、特定の拡張機能の定数は現在のところ含みません。

トレイト、インターフェイスと名前空間

トレイト、インターフェイス、名前空間がImenuリストに表示されるようになりました。フォント表示は名前空間でも正しく動作するようになり、namespace Foo\Bar\Bazのようなコードはもはや警告されません。use <namespace> as <alias>のような名前空間のエイリアスも同様です。現在のところエイリアス名はImenuのリストには含まれませんが、将来のバージョンでは対応予定です。

アンダースコアの取り扱い

PHPモードは$foo_bar_bazのような変数名の単語のそれぞれの部分を移動できるように、アンダースコア(_)を「シンボル構成要素 (symbol constituents)」(Emacs用語)として取り扱います。

メソッドチェーン呼び出し

複数行にわたるメソッド呼び出しを->の位置に揃えること(アライメント)ができます。

$object->foo()
       ->bar()
       ->baz();

この動作はデフォルトでは無効ですが、カスタマイズ変数 php-lineup-cascaded-calls セットすることで有効化できます。

注意: アライメントは、PHPモードのコーディングスタイルのひとつを使用するか、それを継承した場合のみ機能します。

ネストされた配列の整形

ネストされた関数呼び出しと array() 構文は現在デフォルトで(少くとも私の意見では)よく見えるようになりました。例として、このようなスタイルです：

$results = Post::model()->find(
    array(
        'select' => 'title',
        'condition' => 'postID=:postID',
        'params' => array(':postID' => 10),
    )
);

無名関数

以下のような無名関数

$greet = function($name) { ... };

これは現在、Imenuで$greetとして表示します。

Flymakeサポート

カスタマイズ変数php-executableをセットすることで、コーディング中に警告とエラーをリアルタイムで見るためにFlymakeモードを有効にすることができます。

ローカルのドキュメントを検索する

コマンドC-c C-fでカーソル位置のシンボルをPHP公式サイトのドキュメントから検索できます。また、ローカルにドキュメントをダウンロードしてあれば、それを優先します。php-manual-pathをセットするだけです。もしローカルで発見できなければPHPのWebサイトにフォールバックします。

選択範囲内のコードを実行する

php-send-regionコマンド(デフォルトではC-c C-r)はリージョンで選択された範囲のPHPコードを実行します。C-x hと組合せてコード全体を実行することもできます。出力は *PHP* バッファに現れます。

PHPDoc タグ／アノテーション

PHPDocはJavaDocに似たドキュメンテーションの形式です。

@param, @return, @var... などの表記はタグと呼ばれ、list of tags defined by phpDocumentor2で定義されます。 (これらのタグはPhpStormやPhanといった型チェッカーと互換性があります。)

アノテーションと呼ばれる記法は部分的にサポートしています。アノテーションの文法はタグとは少し異なり、@Annotation(attr1="vvv", attr2="zzz") のような形式です。

SymfonyプロジェクトやGo! AOPなどいくつかのプロジェクト・フレームワークはDoctrine Annotationsの文法を元にしています。

/**
 * Summary of Product class
 *
 * @copyright 2112 John Doe
 * @license https://spdx.org/licenses/Apache-2.0.html Apache License 2.0
 * @ORM\Entity
 * @ORM\Table(name="product")
 */
class Product
{
    /**
     * @ORM\Id
     * @ORM\Column(type="integer")
     * @ORM\GeneratedValue(strategy="AUTO")
     */
    protected $id;

    /**
     * @ORM\Column(type="string", length=100)
     */
    protected $name;

    /**
     * @ORM\Column(type="decimal", scale=2)
     */
    protected $price;

    /**
     * @ORM\Column(type="text")
     */
    protected $description;
}

アノテーションは @ から始まる行で、わかりやすく強調表示されます。ただしPHPモードはPSR-5: PHPDoc (草案)の完全なサポートは実装していません。我々は将来的にこれらの強調表示を厳密にサポートしたいと考えていますが、現在の実装は限定的です。詳しくは#478をご覧ください。

コーディングスタイル

PHPモードはデフォルトではphp-enable-default-coding-style関数で設定される合理的なインデントと整形スタイルを提供します。また、ほかの有用なコーディングスタイルも提供しているので、以下の関数を通じて設定することができます。

php-enable-pear-coding-style
php-enable-drupal-coding-style
php-enable-wordpress-coding-style
php-enable-symfony2-coding-style
php-enable-psr2-coding-style

M-x customize-group <RET> phpで‘PHP Mode Coding Style’を探してカスタマイズメニューを探して、デフォルトのコーディングスタイルの設定を有効化することができます。以下のように、コーディングスタイルごとにフックを有効化することもできます。

(add-hook 'php-mode-hook 'php-enable-default-coding-style)

Symfony2 Style

このスタイルではメソッドチェーンのインデントの継続とぶらさがったセミコロンを整形できます。

    $user1
        ->setCreateDate(new \DateTime('2007-05-07 01:34:45'))
        ->setLastDate(new \DateTime('2012-08-18 19:03:02'))
        ->setUsername('jay')
    ;

このスタイルはSymfony2のコードベースで広く利用されていますが、慣習についての文書で明示的に言及されているものではありません。

定数の追加

フレームワークによって一般的な定数群が定義されるならば、変数php-extra-constantsを値をカスタマイズすることができます。これはPHPモードが追加の定数として扱う定数名の文字列のリストです。これらの定数はPHP組み込みの定数と同じ強調表示を行います。

Web Mode定数とキーワード

もしあなたがWeb Modeを使用しているなら、Web Modeに設定された追加のPHP定数をとキーワードを追加しようとします。

HTMLテンプレートのサポートを無効化する

多くの開発者はPHPモードで純粋なPHPスクリプト(HTMLテンプレートを含まないもの)を編集します。HTMLとの互換レイヤーはPHPモードの歴史的な機能ですが、完全には機能していません。速度の低下や強調表示を破壊するおそれがあるなどの副作用があります。変数php-template-compatibilityをnilにセットすると、HTMLとの互換性を無効化することができます。HTMLやその他のマークアップ言語のテンプレートエンジンを含むPHPスクリプトを開発する際はWeb Modeは優れた選択肢です。

Subword Mode

GNU EmacsにはSubword Modeという機能があり、このマイナーモードはキャメルケースの部分を別の単語のように移動することができます。たとえば、PHPモードはデフォルトでは変数$fooBarBazを一つの単語として扱います。しかしSubword Modeを有効にすればEmacsはこの変数名を3つの単語として扱い、単語関係のコマンド(M-f, M-b, M-dなど)はカーソル位置のキャメルケースの各部分に影響します。

もしPHPファイルで常にSubword Modeを有効化したいならば、以下のように設定できます。

(add-hook 'php-mode-hook (lambda () (subword-mode 1)))

キーバインド C-c C-w はSubword Modeのオンとオフを切り替えます。

Amakaサポート

Viewing and editing build scripts for Amaka will automatically enable PHP Mode.

現在のclass/namespaceを挿入する

(with-eval-after-load 'php-mode
  (define-key php-mode-map (kbd "C-c C--") 'php-current-class)
  (define-key php-mode-map (kbd "C-c C-=") 'php-current-namespace))

PHPプログラミングのためのパッケージ

入力補完
- ac-php: company-mode and auto-complete for PHP
構文チェック
- flycheck: On the fly syntax checker
- flymake-php: flymake for PHP files
スニペット
- php-auto-yasnippets: Dynamically Generated YASnippets for PHP Code
ドキュメント
- ggtags: eldoc by using GNU global tags
- php-eldoc: eldoc backend for PHP
テスト
- phpunit: phpunit test command tool
コーディングスタイル
- phpcbf: PHP_CodeSniffer for Emacs
Semantic
- ede-php-autoload: Semantic for PHP
フレームワーク
- cake: minor-mode for CakePHP
- cake2: minor-mode for CakePHP2

貢献するには

CONTRIBUTING.mdをご覧ください。

Wiki

GitHubのプロジェクトページにはwikiがあり、自由に編集して構いません。このWikiには今後追加する計画のある機能やバグが掲載されています。また、PHPモードをより使いやすくするためのTipsを追加できます。

ライセンス

PHP Mode uses the GNU General Public License 3.

Contributors

PHPモードの改善に協力したすべての貢献者のリストはREADME.md#contributorsに掲載されています。

Files

README.ja.md

Latest commit

History