Emacs可通过配置php-mode、lsp-mode、company-mode等核心包打造高效PHP开发环境，结合intelephense语言服务器与Xdebug调试工具，实现语法高亮、智能补全、实时检查、代码跳转和调试功能，配合magit与projectile提升版本控制与项目管理效率，虽初期配置较复杂，但能构建高度定制化、键盘驱动的沉浸式开发体验，长期使用显著提升编码效率与掌控感。
PHP文件本质上就是文本文件，所以任何文本编辑器都能打开它，比如Windows自带的记事本、macOS的TextEdit，或者跨平台的Sublime Text、VS Code。但如果你想进行专业的PHP开发，Emacs无疑是一个强大且高度可定制的选择，它能通过一系列配置和插件，提供从代码编辑、语法高亮、智能补全到调试和版本控制的全方位支持。
PHP文件用Emacs配置PHP开发环境的详细指南
说实话，刚接触Emacs的时候，那纯粹的文本界面和反直觉的快捷键组合，让我一度怀疑人生。但坚持下来，你会发现它真的能成为你思维的延伸。配置Emacs来开发PHP，远不止是安装一个插件那么简单，它是一个逐步打磨你个人工作流的过程。
Emacs为何能成为PHP开发的利器？
立即学习“PHP免费学习笔记（深入）”；
你可能会问，现在有那么多“开箱即用”的IDE，比如PhpStorm、VS Code，我为什么要费劲去学Emacs？这个问题问得好，也是我当初挣扎过的。对我来说，Emacs的魅力在于它的极致可塑性和“手感”。它不像某些IDE那样，一启动就加载一堆你可能用不到的功能，它更像一块璞玉，你可以根据自己的需求，一点点雕琢。
首先，Emacs是完全键盘驱动的。这意味着一旦你熟悉了它的键位，你的双手几乎不用离开键盘，效率自然就上去了。这种沉浸式的编码体验，能让你更专注于代码本身，而不是在鼠标和键盘之间来回切换。其次，Emacs的扩展性是出了名的。通过Lisp语言编写的Elisp，你可以为Emacs添加任何你想要的功能，或者修改现有功能的行为。这对于PHP开发来说尤其重要，因为PHP生态系统发展迅速，新的框架、工具层出不穷，Emacs社区总能很快地推出相应的支持。最后，也是最主观的一点，EmEmacs有一种独特的哲学，它鼓励你去理解和定制你的工具。这种掌控感，是许多其他编辑器难以提供的。它不只是一个编辑器，它更像是一个可以运行你所有开发工具的迷你操作系统。
配置PHP开发环境的核心Emacs包有哪些？
要让Emacs成为一个高效的PHP开发环境，你需要一些核心的“武器”。这些包协同工作，才能提供媲美甚至超越专业IDE的功能。
-
php-mode
: 这是基础，提供了PHP语法高亮、自动缩进、代码块折叠等基本功能。没有它，Emacs就只是一个普通的文本编辑器。 -
company-mode
: 提供了强大的代码补全功能。它可以与各种后端（如LSP、字典、文件内容）结合，提供上下文敏感的补全建议。 -
lsp-mode
或eglot
: 这是现代IDE智能功能的核心。它们实现了Language Server Protocol (LSP) 客户端。配合一个PHP的LSP服务器（比如intelephense
或php-language-server
），Emacs就能获得代码跳转、符号查找、重构、实时错误检查等高级功能。我个人更倾向于lsp-mode
，因为它社区更活跃，功能也更全面。 -
flycheck
或flymake
: 这两个包提供“空中拼写检查”功能，也就是实时语法检查和代码风格提示。它们可以集成PHP的各种linter工具，比如PHPCS (PHP Code Sniffer) 或 PHPStan。 -
magit
: 如果你用Git，那么magit
绝对是Emacs里最值得吹嘘的包之一。它将Git的所有操作都以一种直观、高效的方式集成在Emacs中，让你几乎可以不用离开编辑器就能完成版本控制。 -
dap-mode
: 用于调试。通过配置，它可以与Xdebug等PHP调试器后端连接，提供断点设置、单步执行、变量查看等调试功能。虽然配置起来有点复杂，但一旦跑起来，效率非常高。 -
projectile
: 用于项目管理。它可以快速切换项目、查找项目文件，对于多项目开发者来说，非常实用。
手把手教你配置Emacs PHP开发环境
现在，我们来一步步地把这些工具整合起来。我假设你已经安装了Emacs，并且对
init.el文件（或
.emacs）有所了解。
1. 配置MELPA包管理器
Emacs的包生态系统主要通过MELPA（或MELPA Stable）来管理。如果你还没有配置，先在你的
init.el中添加：
(require 'package)
(add-to-list 'package-archives '("melpa" . "https://melpa.org/packages/") t)
;; 如果你希望使用更稳定的版本，可以添加melpa-stable
;; (add-to-list 'package-archives '("melpa-stable" . "https://stable.melpa.org/packages/") t)
(package-initialize)
;; 确保包列表是最新的
(unless (package-installed-p 'use-package)
(package-refresh-contents)
(package-install 'use-package))
(require 'use-package)重启Emacs，然后执行
M-x package-refresh-contents来更新包列表。
2. 安装核心PHP开发包
现在，我们可以用
use-package来安装和配置上面提到的包。
use-package能让你的配置更清晰、模块化。
;; php-mode
(use-package php-mode
:ensure t
:mode ("\\.php\\'" . php-mode)
:config
;; 推荐的缩进设置，根据PSR规范通常是4个空格
(setq php-mode-indent-offset 4)
(setq php-mode-coding-style 'psr2) ;; 或者 'wordpress, 'drupal 等
(add-hook 'php-mode-hook
(lambda ()
(setq tab-width 4)
(setq indent-tabs-mode nil) ;; 禁用tab，使用空格
(electric-indent-mode 1)
;; 其他针对php-mode的自定义设置
)))
;; company-mode (补全)
(use-package company
:ensure t
:init (global-company-mode)
:config
(setq company-idle-delay 0.1) ;; 补全提示的延迟时间
(setq company-minimum-prefix-length 2) ;; 最少输入多少字符才提示
(setq company-tooltip-limit 10) ;; 补全提示框最多显示多少项
)
;; lsp-mode (语言服务器协议)
(use-package lsp-mode
:ensure t
:commands (lsp lsp-deferred)
:hook ((php-mode . lsp-deferred))
:init
(setq lsp-keymap-prefix "C-c l") ;; 设置LSP快捷键前缀
:config
(setq lsp-enable-symbol-highlighting t)
(setq lsp-signature-auto-activate t)
(setq lsp-ui-doc-enable t) ;; 启用LSP UI的文档提示
(setq lsp-enable-snippet nil) ;; 禁用LSP的snippet，如果你有yasnippet可以考虑禁用
;; 配置PHP语言服务器 (以intelephense为例)
(lsp-register-client
(make-lsp-client :new-connection (lsp-stdio-connection "intelephense" "--stdio")
:major-modes '(php-mode)
:remote? nil
:server-id 'intelephense)))
;; lsp-ui (LSP的用户界面增强)
(use-package lsp-ui
:ensure t
:commands lsp-ui-mode
:hook (lsp-mode . lsp-ui-mode)
:config
(setq lsp-ui-doc-position 'at-point ;; 文档提示在光标位置
lsp-ui-sideline-show-code-actions t ;; 侧边栏显示代码动作
lsp-ui-sideline-show-hover t ;; 侧边栏显示hover信息
lsp-ui-peek-enable t))
;; flycheck (实时语法检查)
(use-package flycheck
:ensure t
:init (global-flycheck-mode)
:hook (php-mode . flycheck-mode)
:config
;; 配置flycheck使用phpcs (需要先全局安装phpcs)
;; (flycheck-add-next-checker 'php-phpcs 'php-phpcs-standard)
;; (setq flycheck-phpcs-standard "PSR12") ;; 例如使用PSR12标准
)
;; magit (Git集成)
(use-package magit
:ensure t
:bind ("C-x g" . magit-status))
;; projectile (项目管理)
(use-package projectile
:ensure t
:config
(projectile-mode +1)
(setq projectile-enable-caching t)
(setq projectile-globally-ignored-directories '(".git" "node_modules" "vendor" ".idea"))
:bind (:map projectile-mode-map
("C-c p" . projectile-command-map)))3. 安装PHP语言服务器
要让
lsp-mode工作，你需要一个PHP语言服务器。最常用的是
intelephense（商业版功能更强，但免费版也很好用）和
php-language-server。你需要全局安装它们。
以
intelephense为例（需要Node.js和npm）：
npm install -g intelephense
或者
php-language-server：
composer global require felixfbecker/php-language-server
然后确保你的Emacs配置中
lsp-register-client的
new-connection部分指向了正确的服务器可执行文件。
4. Xdebug调试 (DAP-mode)
调试是开发中不可或缺的一部分。
dap-mode是Emacs中调试的通用接口。
(use-package dap-mode
:ensure t
:after lsp-mode
:config
(dap-mode-hook)
;; 配置PHP Xdebug
(require 'dap-php)
(setq dap-php-debug-program "php") ;; 如果php不在PATH中，需要完整路径
(setq dap-php-xdebug-port 9003) ;; Xdebug默认端口
;; 示例：配置一个PHP CLI调试的启动配置
(dap-register-debug-template
"PHP CLI"
(list :type "php"
:request "launch"
:name "Launch PHP CLI"
:program "${file}"
:args nil
:cwd "${fileDirname}"
:port 9003
:runtimeExecutable "php")))要使用
dap-mode进行PHP调试，你还需要：
- 在你的PHP环境中启用Xdebug扩展，并在
php.ini
中配置好，例如：zend_extension=xdebug.so xdebug.mode=debug xdebug.start_with_request=yes ; 或 trigger, 根据需要设置 xdebug.client_port=9003 xdebug.client_host=127.0.0.1
- 在Emacs中，打开你的PHP文件，然后执行
M-x dap-debug
，选择你配置的"PHP CLI"模板。
小贴士和注意事项：
-
性能问题： 如果你的项目非常大，
lsp-mode
可能会消耗较多资源。你可以尝试调整lsp-idle-delay
等参数。 -
错误排查： 如果LSP没有启动，可以查看
*Messages*
缓冲区和*lsp-log*
缓冲区（M-x lsp-toggle-log
）获取错误信息。通常是PHP语言服务器没有正确安装或路径不对。 -
快捷键冲突： Emacs的快捷键非常多，有时新安装的包会与你现有的配置冲突。这时候需要查看包的文档，或者使用
C-h k
来查看某个快捷键的功能。 - 持续学习： Emacs的配置是一个持续优化的过程。多看看别人的配置，多逛逛Emacs社区，你会发现很多提升效率的奇技淫巧。
这个配置过程可能看起来有些繁琐，但一旦你构建起一个符合自己习惯的Emacs环境，你会发现它能极大地提升你的开发效率和乐趣。它不是那种“一劳永逸”的工具，更像是一个忠实的伙伴，你投入多少，它就能回馈你多少。
