Laravel与PhpSpec集成指南

1. 项目目录结构及介绍

在应用中整合 phpspec-laravel, 通常不会改变你的核心Laravel框架的目录结构。Laravel默认的目录结构保持不变，主要包括：

• app: 应用的核心代码，包括模型、控制器、中间件等。
• database: 存放迁移文件、种子文件和数据库工厂。
• tests: 即使打算使用PhpSpec进行部分测试，传统的测试文件（如PHPUnit）也可能存放于此。

对于PhpSpec特定的测试结构，建议遵循以下实践来组织测试代码：

• spec: 这是你将创建的所有PhpSpec测试规范的家。可以进一步细分为子目录，比如models、controllers等，以模仿应用程序的结构。

示例目录结构可能看起来像这样:

your-laravel-app/
│
├── app/
│   ├── ...
│
├── database/
│   └── ...
│
└── spec/
    ├── controllers/
    │   ├── YourControllerSpec.php
    ├── models/
    │   ├── YourModelSpec.php
    └── phpspec.yml

2. 项目的启动文件介绍

在PhpSpec的世界里，主要通过命令行界面来执行测试，而不是像传统Web应用那样有一个单一的启动文件。当你运行 phpspec run 命令时，PhpSpec会根据配置文件(phpspec.yml)来确定如何加载环境和查找测试用例。

然而，在结合Laravel时，关键在于 phpspec.yml 配置文件内的设置，它确保了测试能在Laravel的应用上下文中执行。这替代了常规的“启动”概念，由扩展自动处理Laravel的初始化。

3. 项目的配置文件介绍

phpspec.yml

phpspec.yml 是PhpSpec的核心配置文件，对于 phpspec-laravel 的集成至关重要。一个基础配置示例如下：

extensions:
    PhpSpec\Laravel\Extension\LaravelExtension: ~

suites:
    model_suite:
        namespace: App\Models
        spec_prefix: spec/models
        src_path: app/Models
    controller_suite:
        namespace: App\Http\Controllers
        spec_prefix: spec/controllers
        src_path: app/Http/Controllers

• Extensions: 指定了 phpspec-laravel 扩展，让PhpSpec能够加载和利用Laravel的环境。
• Suites: 定义了不同的测试套件，每个套件明确了源代码路径(src_path)、规范前缀路径(spec_prefix)以及命名空间(namespace)。这允许按逻辑或结构对测试进行分组。

确保这些配置正确映射到你的应用程序的实际结构，并且命名空间与你的Laravel应用内部使用的相匹配。这样，PhpSpec就能够找到正确的类文件并运行对应的规范测试。

通过以上步骤，你可以充分利用PhpSpec的功能来对Laravel应用程序进行行为驱动开发(BDD)，确保代码质量和设计的纯洁性。