Emacs PHP Mode

A powerful and flexible Emacs major mode for editing PHP scripts

PHP ModeのGitHubプロジェクトにissueを作成してバグ報告や機能リクエストを送ってください。

インストール

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

NonGNU ELPAからのインストール

Emacs 28 (未リリース; 次期バージョン) ではNonGNU ELPAがデフォルトのパッケージリポジトリとして追加されています。

;; For Emacs < 28
(when (< emacs-major-version 28)
  (with-eval-after-load 'package
    (add-to-list 'package-archives '("nongnu" . "https://elpa.nongnu.org/nongnu/"))))

(unless (package-installed-p 'php-mode)
  (package-install 'php-mode))

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

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

OSのパッケージマネージャからのインストール

PHP ModeはいくつかのOSが提供するパッケージシステムからインストール可能です。DebianおよびUbuntuのようなDebian派生のOSではEmacsにPHPを追加する最も簡単な方法で、sudo apt install elpa-php-mode で導入できます。これらの "Stable" リリースは最新のPHP Modeよりも古いものの、十分にテストされた固定バージョンが提供されます。オートロードとバイトコンパイルは自動で行われます。

最新のPHP Modeの機能とパフォーマンス改善を活用するためにsid ("unstable"としても知られるローリングリリース)で提供されるバージョンのインストールを検討してください。最新バージョンはelpa-php-modeにあります。"apt-pinning"を使ってアップデートを自動化することもできます。

また、Debian 9 (stretch)やUbuntu 18.10以前で提供されていた php-elisp パッケージはあまりにも古いので、 くれぐれもインストールしないでください。

手動でインストール

もしパッケージマネージャに依存したくなければ、伝統的な方法によってLispファイルを直接インストールすることもできます。詳細なセットアップ方法は手動でのインストールページをご覧ください。

バグを報告する

報告の際には 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-mode-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のコードベースで広く利用されていますが、慣習についての文書で明示的に言及されているものではありません。

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のオンとオフを切り替えます。

現在の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はGNU General Public License Version 3 (GPLv3) でライセンスされています。

このプロジェクトは1999年にTuradg Aleahmadが書いたphp-mode.elに起源を持ちます。2013年にDaniel HackneyがEmacs組み込みのCC Modeをもとに書き直し始めました。PHPモードの改善に協力した貢献者のリストはAuthorsとContributorsに掲載されています。

このプロジェクトは2017年までEric James Michael Ritzによりメンテナンスされていました。現在はFriends of Emacs-PHP Developmentコミュニティが引き継いで開発しています。

Copyright (C) 2018-2020  Friends of Emacs-PHP development
Copyright (C) 1999, 2000, 2001, 2003, 2004 Turadg Aleahmad
              2008 Aaron S. Hawley
              2011, 2012, 2013, 2014, 2015, 2016, 2017 Eric James Michael Ritz
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

README.ja.md

README.ja.md

Emacs PHP Mode

インストール

NonGNU ELPAからのインストール

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

OSのパッケージマネージャからのインストール

手動でインストール

バグを報告する

Settings

個人設定

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

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

CC Mode, CEDET, EDE, and Semantic

PHP7サポート

機能

新しいキーワード

定数

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

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

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

ネストされた配列の整形

無名関数

Flymakeサポート

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

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

PHPDoc タグ／アノテーション

コーディングスタイル

Symfony2 Style

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

Subword Mode

現在のclass/namespaceを挿入する

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

貢献するには

Wiki

著作権

Files

README.ja.md

Latest commit

History

README.ja.md

File metadata and controls

Emacs PHP Mode

インストール

NonGNU ELPAからのインストール

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

OSのパッケージマネージャからのインストール

手動でインストール

バグを報告する

Settings

個人設定

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

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

CC Mode, CEDET, EDE, and Semantic

PHP7サポート

機能

新しいキーワード

定数

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

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

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

ネストされた配列の整形

無名関数

Flymakeサポート

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

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

PHPDoc タグ／アノテーション

コーディングスタイル

Symfony2 Style

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

Subword Mode

現在のclass/namespaceを挿入する

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

貢献するには

Wiki

著作権