Press "Enter" to skip to content

配置开发环境

为什么要配置开发环境?

在开发主题时,最好是在与最终安装WordPress的生产服务器相同的环境中进行。你的开发环境可以是本地或者远程的。配置一个本地开发环境来做WordPress主题开发有以下几点好处:

  • 你可以在本地构建主题,而不需要依赖远程服务器。这样可以加快你的开发进程,允许你在浏览器中实时地看到更新。
  • 你不需要网络连接就可以开发主题。
  • 你可以从多个角度测试你的主题。特别是当你计划将主题发布给更多的受众并希望确保最大的兼容性时,这一点尤为重要。

你的WordPress本地开发环境

为了开发WordPress主题,你需要设置适合WordPress的开发环境。首先你需要一个本地服务器和一个文本编辑器。你可以有以下多种选择:

本地服务器堆栈

本地服务器堆栈,比如你可以在本地机器上配置的LAMP(Linux+Apache+MySQL/MariaDB+PHP)或者WAMP(Windows+Apache+MySQL/MariaDB+PHP)服务器(类似于在Web服务器上运行的服务器)。你可以安装包含这些程序的预捆绑程序,比如适用于MAC上的(MAMP)和MAC和Windows都使用的XAMPP,以快速的设置开发环境。

虚拟环境

通过Vagrant和VirtualBox创建的虚拟环境允许你创建易于复制的开发环境。Varying Vagrant Vagrants (VVV)是一个创建WordPress开发环境的流行Vagrant选项。

文本编辑器

除了本地服务器环境外,你还需要一个文本编辑器来编写代码。你完全可以凭个人意愿挑选文本编辑器,但是请记住,一个好的文本编辑器可以加快你的开发速度。你的文本编辑器可以是从拥有编写代码的基本工具到带有调试和测试工具的完全集成开发环境(IDE)。这是值得探究的,甚至有的编辑器包含了对WordPress开发的支持。热门的选择包括Atom,Sublime Text和PhpStorm。

你可以在页面底部找到设置开发环境的教程列表。

支持旧版本的WordPress

为确保向后兼容,WordPress主题的标准做法是至少支持两个版本。举个例子来说,如果当前WordPress的版本是4.6,则还应该确保主题在4.5和4.4版本中也能正常工作。

你可以参考WordPress线路图页面来访问WordPress的旧版本。然后,你可以下载并安装老版本的WordPress,创建多个开发站点,每个站点运行不同版本的WordPress进行测试。

WP_DEBUG

配置调试是WordPress主题开发的重要组成部分。WordPress提供了许多常量来支持调试工作,包括:

WP_DEBUG

PHP常量WP_DEBUG用于触发WordPress安装时内置的调试模式,这使得你可以在主题中查看错误。要启用它你可以:

  1. 打开主目录下WordPress安装的 wp-config.php 文件。
  2. define( ‘WP_DEBUG’, false ); 改为 define( ‘WP_DEBUG’, true);

通常wp-config.php文件中的WP_DEBUG都被设置为false,但在WordPress的开发副本(发行的alpha和beta版本)中WP_DEBUG默认被设置为true。

WP_DEBUG_DISPLAY 和 WP_DEBUG_LOG

WP_DEBUG_LOG和WP_DEBUG_DISPLAY 是扩展自WP_DEBUG的附加常量。

WP_DEBUG_LOG结合WP_DEBUG使用,将所有的错误信息记录到WordPress的/wp-content/目录下debug.log中。要启用此功能,需要在wp-config.php文件中将WP_DEBUG_LOG设置为true。

define( 'WP_DEBUG_LOG', true );

WP_DEBUG_DISPLAY用于控制调试信息是否在主题页面的HTML中显示,要在遇到错误时显示在屏幕上,请在wp-config.php文件中将 WP_DEBUG_DISPLAY 设置为true。

define( 'WP_DEBUG_DISPLAY', true );

WP_DEBUG和WP_DEBUG_DISPLAY都启用后,错误信息将会显示在网站页面的顶部。

错误信息将会显示在网站的前端和管理区域。这些调试工具用于本地测试和临时安装,而不能用于线上站点(译者注:不推荐用于生产环境)。

其他WordPress开发工具

除了WP_DEBUG,以下插件和单元测试数据集也是开发工具集的重要组成部分,可帮助你更好地开发WordPress主题。

测试数据

WordPress.org主题单元测试数据

WordPress.org主题单元测试数据是一个XML文件,其中包含虚拟测试数据,您可以上传这些虚拟测试数据来测试主题在不同类型和内容布局下的效果。

WordPress.com主题单元测试数据

WordPress.com主题单元测试数据是虚拟测试数据,你可以将其上传到WordPress安装中来测试你的主题,包括WordPress.com特定的功能。

插件

Debug Bar (WordPress插件)

Debug Bar在WordPress管理面板添加了一个管理栏,提供了一个集中的调试区域。

Query Monitor ( WordPress插件 )

Query Monitor允许调试数据库查询,API请求以及用于生成主题页面和功能的 AJAX调用 。

Log Deprecated Notices ( WordPress插件 )

Log Deprecated Notices记录了不正确的功能使用情况以及使用的WordPress已经启用的文件和功能。

Monster Widgets ( WordPress插件 )

Monster Widget将WordPress核心小工具合并成了一个单独的小工具,允许你测试主题中小工具的样式和功能。

Developer ( WordPress插件 )

Developer helps通过允许工具和插件的简单安装来优化你的开发环境,这将有助于进行故障排除并确保代码质量。

Theme-Check ( WordPress插件 )

Theme-Check将测试你的主题是否符合WordPress的最新标准和惯例。

WordPress主题审查指南

除了上述开发工具外,最好随时了解WordPress.org主题审查小组的主题提交准则以及有关符合WordPress编码标准的指南。这些指南是高质量主题开发的“黄金标准”,即使你不打算在WordPress.org上发布主题,这些指南也很有用。

更多资源

Comments are closed, but trackbacks and pingbacks are open.