返回博客

如何使用 ddev 在本地设置 WordPress 或 Drupal 站点

2021-12-224 分钟阅读

DDEV 是一个开源工具,可使用 docker 快速设置本地站点。您无需了解复杂的 docker 概念即可运行本地 WordPress 或 Drupal 站点。您可以在此处 https://ddev.com/get-started/ 和此处 https://ddev.readthedocs.io/en/stable/ 查看其官方文档。

下面列出的步骤/命令是我最需要用到的,因此我将此笔记发布到网上,以便将来作为我自己的参考,或帮助其他可能需要的人。

如何安装 DDEV

  1. 按照 https://brew.sh/ 上的步骤安装 homebrew
  2. 确保您已安装 docker。如果不确定如何安装,可以按照此 链接 中的步骤进行。
  3. 安装 ddev (MAC): brew install drud/ddev/ddev
  4. 您需要为每个项目运行一次 ddev config 来设置它。从您计划存放所有项目相关文件的文件夹中运行此命令。它会问您三个问题:
    1. 站点名称是什么?
      • 我建议您选择一个容易记住的单词。它将用于您必须在浏览器中打开站点的本地域名。例如:如果您选择 localsite 作为项目名称,您将通过浏览器访问站点,网址为 https://localsite.ddev.site/ 
    2. 文档根目录的位置是什么?
      1. 这是您克隆或计划克隆项目文件的文件夹。我建议在运行第 1 步中的 ddev config 命令的同一文件夹中创建一个名为 web 的文件夹。 
    3. 这是什么类型的项目?例如 Drupal、PHP、WordPress 等。
  5. 您需要运行 ddev start 来启动并运行项目。如果您记得项目名称,可以从文件夹外部运行该命令。
  6. 想要导入数据库吗?您可以从项目目录运行 ddev import-db –file=dumpfile.sql.gz 。它会在导入新的数据库备份之前删除现有数据库。
  7. 如果需要运行 composer、drush 或 wp-cli 命令怎么办?您应该运行 ddev ssh
  8. 遇到错误需要查看日志吗?您应该运行:ddev logs -f
  9. 在我的一些 Drupal 项目中,在能够运行 drush 之前,我需要运行此命令:ddev composer require drush/drush
  10. 需要获取站点的 URL、端口或检查服务是否处于活动状态?ddev describe 将为您提供这些信息。
  11. 如果需要让您的本地站点使用 https,您应该运行:mkcert -install
  12. 需要使用 xdebug 调试 PHP 代码吗?您需要运行 ddev xdebug 来启用它。运行 ddev xdebug off 将再次禁用它。
  13. 您使用的是 Mac,并且您的本地站点运行非常缓慢,您应该运行 ddev config global –mutagen-enabled,它将在全局启用 mutagen。您会立即注意到差异。
  14. 如果您按照第 12 步操作,并且需要更新大量文件(也许是更新插件或模块?),mutagen 可能需要一些时间才能检测到更新的文件,因此您可能需要运行 ddev mutagen sync 来加速同步过程。
  15. 需要使用不同的 PHP 版本测试您的站点,因此您可以使用 ddev config –php-version 8.0。8.0 可以是您需要的任何 PHP 版本。
  16. 安装 memcached:
    1. 在最新的 ddev 版本中,您需要运行:ddev get drud/ddev-memcached && ddev restart
    2. 对于 WordPress,在 wp-config.php 中,您需要添加以下行:
/**
 * Memcache 设置。
 */
$memcached_servers = [
    'default' => [
        'ddev-YOUR_PROJECT_NAME-memcached:11211',
    ]
];

# 为每个项目替换密钥并将其保存在 git 中
define( 'WP_CACHE_KEY_SALT', 'random_cache_key_salt' );