README

要求

开发工作流程使用ddev。请参考ddev文档以获取要求。简而言之，您需要使用

• ddev
• docker
• git
• PHP composer
• 您选择的编辑器。对于高级开发，我们建议使用PHP Storm。
• Drupal drush
• xdebug进行逐步调试（《使用xdebug与ddev》）

创建项目

git clone git@bitbucket.org:publicplan/degov_project.git

现在根据您的需求重命名项目是个好时机。在这个示例中，我们将项目重命名为degov_project_91

mv degov_project degov_project_91

安装PHP依赖项

这将下载deGov及其依赖项。

cd degov_project_91
composer install # or ddev composer install

启动ddev环境

ddev使用Docker镜像来构建您的环境。这些镜像包括一个web服务器，一个Maria-DB服务器，在某些情况下还有一个Solr搜索服务器。

如果您调整了端口号，您可以使用多个ddev实例。

选择端口号（边缘情况）

您应该在.ddev/config.yaml中更改以下变量。在这个示例中，我们将使用

name: degov
router_http_port: "8091"
router_https_port: "8092"

现在您应该能够运行

cd degov_project_91
ddev start

[...]

Successfully started deGov
Project can be reached at https://degov.ddev.site:8092 https://127.0.0.1:62045

注意：要停止所有ddev开发环境并释放使用的资源，您可以运行ddev poweroff

常见问题

如果您的端口号已被其他东西占用，您可能会看到类似的消息

Failed to start deGov:
Unable to listen on required ports, port 80 is already in use

在这种情况下，根据上述说明更改端口号。

安装deGov

当ddev运行时，您只需在浏览器中打开https://degov.ddev.site:8092即可访问ddev web服务器上的Drupal安装页面。由于这是一个常见的Drupal标准，我们在此不再详细说明。

安装包含演示内容的deGov

对于开发或快速了解deGov，我们建议使用演示内容Drupal模块（degov_demo_content）。

为了可重复的开发，我们提供了一个名为kickstart的自定义ddev命令。

运行kickstart将会删除当前项目中所有文件和数据库。大致上它会执行以下操作

• 安装依赖项
• 创建一个local.settings.php文件
• 删除您的数据库（drush sql-drop）
• 删除并重新创建sites/default/files
• 导入当前的deGov稳定数据库
• 运行Drupal数据库和区域更新

详细信息请参阅degov_project_91/.ddev/commands/web/kickstart。

cd degov_project_91
# Asuming you did a composer install and ddev start.
ddev kickstart

现在您应该在浏览到https://degov.ddev.site:8092时看到所有预告页面。

以管理员身份登录

登录到您的deGov演示页面的推荐方式是使用drush user-login（drush uli）。使用ddev时，您会这样做

cd degov_project_91
ddev drush uli

ddev快速提示

我们建议阅读ddev文档。您可以运行drush命令和许多其他事情。以下是一些示例

# List all ddev commands in project
ddev

# Get a detailed description of a running ddev project
ddev describe

# run any drush command
ddev drush <drush command>

# login to the (docker) webserver
ddev ssh

# Restart ddev (e.g. after ddev config change)
ddev restart

# Turn off ddev and shut down all its servers
ddev poweroff

# Inspect the database using Sequel Pro (macOS)
ddev sequelpro

# Run xdebug
# See https://ddev.readthedocs.io/en/stable/users/step-debugging
ddev xdebug

Xdebug

Xdebug提供调试和性能分析功能。您可能需要配置您的IDE。

您还可以调试drush命令。例如

ddev xdebug
ddev exec PHP_IDE_CONFIG=serverName=nrwgov91.ddev.site /var/www/html/vendor/drush/drush/drush updb -y

最后备注

我们——deGov开发团队——很久以前就开始了。我们可能对这个文档视而不见，或者认为一些事情是初学者从未听说过的。

请帮助我们改进这份文档

开源软件的生命力在于贡献。改进文档是开始贡献最推荐的方式之一 ;)

来源：https://bitbucket.org/publicplan/degov_project/src/HEAD/README.md