README

“Proclaim Honestly, Interact Liberally” WebSymfony 是一个增强版的 Symfony 7.0 应用骨架，可直接使用。

WebSymfony 的目的是提供一个带有一些合理默认值的沙盒环境，并可直接使用。如果您想要快速搭建一些东西，创建一个 POC，测试一些内容，甚至制作一个简单的“单页”应用，它都可以作为一个解决方案。

它基于 strangebuzz/MicroSymfony，并加入了我们在所有项目中通常添加的调整。我们还移除了许多示例。

演示 🌈

因为一个实时演示总是比所有的解释都要好。这里就是

• 实时演示将在 https://ph-il.ca/demos/websymfony 上提供

要求 ⛮

所有“Proclaim Honestly, Interact Liberally”项目将使用在 1 到 2 个月内可用的最新版本。

• PHP 8.3
• Symfony CLI

可选要求 ⚙

• 如果您想运行代码覆盖率报告，则需要Xdebug PHP 扩展（可选但推荐）
• Castor 0.9.1 任务运行器（可选）

堆栈 🔗

所有“Proclaim Honestly, Interact Liberally”项目将使用在 1 到 2 个月内可用的最新版本。

• Symfony 7.0
• Twig 3.8
• Stimulus 3.2
• PHPUnit 11.0

功能 🚀

WebSymfony 提供以下功能，可直接使用

• 一个任务运行器
  • Castor (源代码)
• 使用 PHPStan 进行静态分析
  • 配置
• 使用 php-cs-fixer 进行编码标准检查
  • 配置
• 使用 Rector 进行重构
  • 配置
• 调试工具栏（文档）
• 测试（《组织》）
  • 单元测试 示例
  • 集成测试 示例
  • 功能测试 示例
  • API 测试 示例
  • 端到端测试 示例
• 代码覆盖率 100%
  • CI 输出
  • 失败的输出示例
• GitHub CI（《操作》）
  • 测试作业输出
  • lint 作业输出
• 资产映射+Stimulus（《文档》）
  • 纯 Js（《源代码》）（《演示》）
  • 从应用的JSON端点获取数据（源代码）（演示）
• Tailwind CSS
• Symfony Maker（文档）
• 自定义错误模板
  • 源代码
  • 演示
• 数据库
  • Doctrine（文档）
  • Doctrine Migrations（文档）
  • Doctrine Fixture（文档）
  • Doctrine Extensions（在Symfony中的配置配置）（文档）
• 对象菜单（示例）
• 安全层
  • SymfonySecurity（文档）
  • NelmioSecurityBundle（文档）
  • NelmioCorsBundle（文档）
• 管理界面
  • EasyAdmin（文档）

其他优秀实践 👌

• 在所有PHP文件中使用严格类型（源代码）
• 在动作控制器中使用ADR模式（源代码）（文档）
• composer.json文件使用ergebnis/composer-normalize进行了标准化（源代码）
• 使用composer bin插件安装和运行php-cs-fixer。

使用WebSymfony 🪄初始化应用程序

使用composer初始化

由于应用程序模板已在Packagist上注册（注册），您可以使用以下命令使用composer安装它

$ composer create-project phil/websymfony

它创建了一个包含新项目的websymfony目录。在这种情况下，您必须自己设置Git和仓库。但这是最快的方法来测试它。

请注意，composer install命令下载所有必需的依赖项并构建资源。

从GitHub网站初始化

或使用GitHub模板

从GitHub CLI初始化

$ gh repo create my-project --clone --private --template parler-haut-interagir-librement/WebSymfony

托管应用程序

要使用Symfony二进制文件托管应用程序，请运行

$ symfony server:start --daemon

或使用castor命令

$ castor symfony:start

应用程序现在可在https://127.0.0.1:8000（假设您的8000端口可用）上访问。

参考资料 📚

• 安装和使用php-cs-fixer（strangebuzz.com）
• Castor，穿越任务运行器海洋之旅（jolicode.com）
• 使用坚实基础初始化您的Symfony项目（strangebuzz.com）
• 组织您的Symfony项目测试（strangebuzz.com）
• 你的Symfony最佳实践是什么？ (strangebuzz.com)
• 借助GitHub Actions为Symfony项目设置CI/CD工作流程 (strangebuzz.com)
• Symfony框架最佳实践 (symfony.com)

其他“坦诚，自由互动”的骨架 🩻

• MicroSymfony

  • 任务运行器
    • Castor
  • 静态分析
    • PHPStan
  • 编码规范
    • php-cs-fixer
  • 重构
    • Rector
  • 调试工具栏
  • 测试
    • 单元测试
    • 集成测试
    • 功能测试
    • API测试
    • E2E测试
  • GitHub CI
  • 资源映射器
  • Stimulus
  • Symfony Maker
  • 自定义错误模板

• ApiSymfony

  • API Platform
  • 任务运行器
    • Castor
  • 静态分析
    • PHPStan
  • 编码规范
    • php-cs-fixer
  • 重构
    • Rector
  • 测试
    • 单元测试
    • API测试
    • E2E测试
  • GitHub CI
  • Symfony Maker

• WebSkeleton

  • WebSymfony +
  • CSS框架
    • Tailwind CSS
    • DaisyUI : 为Tailwind CSS添加语义
  • “坦诚，自由互动”捆绑包
    • phil-ux - 添加基础Twig组件
      • 安装Tailwind CSS和DaisyUI
      • 使用DaisyUI语义添加基础Twig组件
    • PhilDoctrineExtensionStofBundle - 为StofDoctrineExtensionsBundle添加缺失功能
    • PhilDoctrineExtensionPublishBundle - 为Doctrine实体添加发布功能
  • 更多。