故障排除指南 编辑

在开始报告上的新问题之前githubgithub GitHub是一个提供git存储库在线实现的网站,其他开发人员可以轻松共享、复制和修改这些存储库。公共存储库可以免费托管,私有存储库需要付费订阅。GitHub引入了“拉取请求”的概念,在将贡献者在分支中所做的代码更改合并为存储库所有者之前,可以对其进行审查和讨论。https://github.com/存储库中,请确保检查您的本地安装,因为某些设置通常会导致您的WP-CLI公司WP-CLI公司 WP-CLI是WordPress的命令行界面,用于以编程方式执行管理和开发任务。项目页面是http://wp-cli.org/ https://make.wordpress.org/cli/命令。

如何获取有关WP-CLI安装的详细信息?

WP-CLI提供以下命令wp--信息,它为您提供了许多有关WP-CLI安装环境的信息。输出将告诉您,
*您使用什么操作系统和shell
*其中菲律宾比索菲律宾比索 PHP(PHP:Hypertext Preprocessor的递归缩写)是一种广泛使用的开源通用脚本语言,特别适合web开发,可以嵌入到HTML中。http://php.net/manual/en/intro-whatis.php二进制文件用于运行WP-CLI
*使用什么版本的PHP
*在哪里可以找到WP-CLI的根目录
*哪里可以找到WP-CLI的供应商目录
*您当前使用的WP-CLI二进制文件(phar路径)
*存储WP-CLI包的位置
*在哪里可以找到WP-CLI和
*您使用的WP-CLI版本。

顶部↑

在开始调试问题之前,我应该做什么?

在开始调试问题之前,请确保使用的是最新版本的WP-CLI。最新版本可能已经解决了您遇到的问题。命令wp-cli更新将升级您的WP-CLI版本,或者确认您已经使用了最新版本。如果安装挂起,请确保允许您使用连接到GitHubSSL协议SSL协议 安全套接字层-从服务器到浏览器再到浏览器的加密。防止窥探者看到您在浏览器和服务器之间发送的内容。(端口443)和git(端口9418)用于出站连接。

顶部↑

如果WP-CLI输出与预期不同,我应该怎么做?

在开始调查错误之前,您应该了解可以更改WP-CLI默认行为的因素,以及如何检查这些因素是否是问题的根源。有五个主要子系统用于修改此默认行为:环境变量、配置文件、WP-CLI包、,wp-config.php文件和WordPress扩展名(插件、主题、必须使用的插件、下拉列表)。

顶部↑

环境变量

工作环境的设置是运行WP-CLI的先决条件。您可以使用shell命令检查当前的环境设置环境价值

如果要使用远程运行WP-CLISSH(SSH)SSH(SSH) 安全SHell-一种除了密码之外或代替密码安全连接到远程系统的协议。,要求命令水处理可以在远程服务器的路径上访问。WP-CLI的行为也可以在运行时通过使用环境变量进行更改:

  • WP_CLI_CACHE_DIR公司–用于存储WP-CLI文件缓存的目录。默认值为~/.wp-cli/cache/
  • WP_CLI_CONFIG_PATH(图形路径)–全局config.yml文件的路径。默认值为~/.wp-cli/config.yml
  • WP_CLI_DISABLE_AUTO_CHECK_UPDATE(WP_CLI_禁用_自动_检查_更新)–禁用WP-CLI自动检查更新。
  • WP_CLI_包装_方向–用于存储通过WP-CLI的包管理安装的包的目录。默认值为*~/.wp-cli/packages/
  • WP_CLI_PHP–PHP重写系统默认值时要使用的二进制路径(仅适用于非Phar安装)。
  • WP_CLI_PHP_ARGS–调用WP-CLI时传递给PHP二进制文件的参数(仅适用于非Phar安装)。
  • WP_CLI_SSH_PRE_CMD公司–使用时--ssh=,请在WP-CLI调用远程服务器上的WP-CLI之前执行命令。
  • WP_CLI_STRICT_ARGS_模式–通过告诉WP-CLI将命令之前的任何参数视为全局参数,将命令之后的任何参数视为局部参数,避免歧义。

要按需设置环境变量,可以将环境变量定义放在要运行的WP-CLI命令之前(例如。EDITOR=vim wp后期编辑1); 要覆盖环境变量,请使用export VARIABLE=值在您的~/.bashrc~.zhsrc

顶部↑

WP-CLI配置文件

配置文件允许您自定义WP-CLI的行为,以使其适应您的个人需要或项目的需要。如果配置文件不正确或包含对默认行为的不需要的修改,WP-CLI的输出很可能会反映错误。

请注意,项目配置文件可以覆盖全局配置文件中的设置。

重命名或删除配置文件并比较结果,以确定是否是配置设置导致了问题。

顶部↑

WP-CLI包

WP-CLI包是基于WP-CLI.构建的社区维护项目。它们可以包含WP-CLI命令,但也可以以某种方式扩展WP-CLI。虽然WP-CLI可能非常有效,但出现错误的程序包也可能导致意外的结果。要跳过加载所有已安装的包,请使用wp—跳过包

顶部↑

WordPress配置文件(wp-配置.php)

移动或编辑可能会导致错误wp-config.php超出WP-CLI支持的范围。如果出现解析错误,请检查wp-config.php(UTF-8,无BOM)。

确保线路require_once(ABSPATH.'wp-settings.php');保留在wp-config.php文件且不修改wp-config.php超越常量定义。如果您在中调用WordPress函数wp-config.php,PHP将失败并返回致命错误。

如果您想使用$服务器['HTTP_HOST']在您的wp-config.php,则需要在WP-CLI上下文中设置默认值:

if(已定义(“WP_CLI”)&&WP_CLI&&!isset($_SERVER['HTTP_HOST']){$_SERVER['HTTP_HOST']=`example.com';}

而不是$_SERVER['document_root']使用目录名(__FILE__)或类似情况。

顶部↑

WordPress扩展

WordPress主题和插件可能会与WP-CLI的加载过程冲突或干扰,例如重定向用户。他们经常做出在WP-CLI上下文中不正确的假设,比如使用当前请求的主机名(这是一个在命令行上下文中不存在的概念)。

您可以绕过单个插件和主题(例如。--跳过插件=akismet)或者完全跳过(wp--跳过插件--跳过主题).

顶部↑

如果WP-CLI报告错误,我该怎么办?

常见问题是您的wp-配置.php或web服务器配置。章节“常见问题”中列出了最常见的错误消息,并解释了如何处理这些错误。

尝试在新安装的WordPress中重现这个问题,使用默认主题(Twenty…),并且没有安装插件。如果问题只在自定义环境中重现,则问题是您的环境中的错误,而不是WP-CLI。还要确保通过设置常量启用WordPress的调试模式定义('WP_DEBUG',true);在您的wp-config.php。它可能会显示现有WordPress安装中的问题,而不是由WP-CLI引起的。

此外,您可以使用WP-CLI的全局参数--调试显示所有PHP错误并向WP-CLI引导程序添加详细信息。

顶部↑

我已经检查了以上所有内容,但仍有问题。我可以在哪里报告问题?

如果您认为您发现了一个错误,我们很乐意收到您的来信以修复它。

WP-CLI的错误报告在GitHub上处理。创建新问题之前,请搜索现有问题查看是否有现有的解决方案。如果您的bug没有打开或修复的问题,请按照我们的准则提交错误报告确保及时解决。提供总结、复制步骤、环境详细信息和下面确定的其他细节将有助于确保您提交完整的错误报告。

请向我们提供:
*以叙事形式总结问题,
*重现问题的详细而具体的步骤列表,
*您工作环境的详细信息,
*描述错误如何影响您的使用(即预期结果与实际结果的比较),包括*严重程度,
*可能的解决方法和
*相关诊断,如崩溃报告、堆栈跟踪或调试输出。

您可以在中找到问题报告这些详细信息的详细描述提交错误报告的准则

上次更新时间: