brumann / workshop-skeleton

研讨会项目骨架。

v1.0.1 2019-06-01 16:01 UTC

This package is auto-updated.

Last update: 2024-08-29 04:49:08 UTC


README

这是一个基本的Symfony应用程序,具有基本的Docker开发设置。

这个容器化的骨架将提供我们在整个研讨会中所需的所有服务,还有一些可以玩的服务。这并不是为生产环境准备的模板,很可能缺少您在常规开发设置中可能需要的东西,如SSL证书。

安装

  1. 从骨架创建项目

    git clone https://github.com/dbrumann/workshop-skeleton.git
  2. 为应用程序构建Docker镜像

    # cd workshop-skeleton
    docker-compose build
  3. 启动Docker容器

    docker-compose up -d

    -d标志是可选的,允许您之后运行其他命令

  4. 安装Symfony应用程序的项目依赖项

    docker-compose exec app composer install

检查一切是否正常工作

一旦您遵循了安装说明,您应该能够使用您喜欢的浏览器打开以下URL

Screenshot of the open browser windows

此外,您应该能够连接到端口3306的MySQL数据库。

如果您可以访问每个部分,您就为研讨会做好了充分的准备,并准备好开始👍

故障排除

我无法连接到一个或多个服务(RabbitMQ、Redis、MySQL)

这可能是因为端口已被占用,例如,由本地实例占用。您可以修改docker-compose.yml以更改暴露给外部的端口号,请检查服务的port:设置并更改冒号前的值。另一个选择是如果您有权限,可以暂时禁用本地服务。

Symfony应用程序只显示一个空白页面

这可能是因为文件权限或挂载卷的问题。请确保在您的Docker首选项中目录具有文件共享权限。

Preferences Pane for File Sharing

我不允许在我的机器上安装Docker

如果您无法使用容器化设置,不要担心。我们不需要提供的大多数服务,只有Symfony应用程序和数据库。请按照以下说明在本地运行事物

  1. 创建项目 composer create-project brumann/workshop-skeleton workshop
  2. 运行PHP内部web服务器: php -S 127.0.0.1:8000 -t public/

此外,请确保您有一个运行中的数据库服务器,如MySQL或Postgres,或者您已安装sqlite3。要确保数据库可用于您的PHP应用程序,您可以使用php -m | grep pdo进行检查。这应该打印出您可以使用的所有可用驱动器的名称。

我已经设置了XAMPP、WAMPP或类似的东西,我可以使用它吗?

是的,但我已经有一段时间没有使用它们了,所以我可能没有时间为您提供适当的帮助,如果您遇到问题。请提前确保您有PHP 7.1+和一个可以使用的数据库。

我该如何运行Symfony控制台命令?

您可以登录到app-service来运行控制台命令,就像您习惯的那样

docker-compose exec app bash

这将在项目文件夹中的容器内打开一个终端,因此之后您可以运行类似 bin/console cache:clear 的命令。如果您只想运行一个命令,也可以将 bash 替换为该命令

docker-compose exec app bin/console cache:clear

一些开发工具,如 PhpStorm,也允许您连接到容器并执行命令。

问题、疑问和建议

如果您在故障排除指南中没有涵盖的其他问题或需要进一步的帮助设置框架,请随时联系我,最好是发电子邮件。

denis.brumann@sensiolabs.de