application-testing

分类: 商业与运营 | 上传者: JUVOJustin | 下载: 0 | 版本: v1.0（最新）

为此 WordPress 插件编写、扩展或调试 PHPUnit 应用程序测试。每当涉及测试时，请使用此技能 - 为新功能添加测试、测试挂钩或过滤器行为、使用工厂测试 WordPress 数据操作，或者当被要求“添加测试”、“编写测试”、“测试此功能”或“通过测试验证此行为”时。该技能与项目基于 wp-env 的设置有关，并取代任何通用的 PHPUnit 指南。 --- # 应用程序测试测试专门在 `wp-env` 测试容器内运行。 bootstrap 和 PHPUnit 配置是预先连接的。不要修改 `tests/bootstrap.php` 或 `phpunit.xml.dist`。测试运行时该插件已加载 - 无需手动操作。如需完整参考，包括常见模式、插件依赖项和 CI 详细信息，请阅读“references/testing.mdx”。 ## 运行测试套件

更新日志: Source: GitHub https://github.com/JUVOJustin/wordpress-plugin-boilerplate

目录结构

当前层级: tree/main/.agents/skills/application-testing/

📁 references/
- 📄 testing.mdx 28 B
📄 SKILL.md 3.4 KB

SKILL.md

---
name: application-testing
description: |
  Write, extend, or debug PHPUnit application tests for this WordPress plugin.
  Use this skill whenever tests are involved — adding a test for a new feature,
  testing hook or filter behavior, testing WordPress data operations with factories,
  or when asked to "add a test", "write tests", "test this function", or
  "verify this behavior with a test". This skill is opinionated about the
  project's wp-env-based setup and supersedes any generic PHPUnit guidance.
---

# Application Testing

Tests run exclusively inside the `wp-env` test container. The bootstrap and PHPUnit config are pre-wired. Do not modify `tests/bootstrap.php` or `phpunit.xml.dist`. The plugin is already loaded when tests run — no manual require needed.

For full reference including common patterns, plugin dependencies, and CI details, read `references/testing.mdx`.

## Running the test suite

Follow these steps in order:

1. **Install test dependencies** — requires `composer` to be available in the current environment (locally or via a container such as DDEV). Installs packages from `tests/composer.json` into `tests/setup/plugins/`. If there are no packages declared this is a no-op, but always run it so CI and local stay consistent.

   ```bash
   npm run env:install-test-deps
   ```

2. **Start wp-env** — requires Docker. Spins up the WordPress development and test containers. Skip if the environment is already running.

   ```bash
   npm run env:start
   ```

3. **Run the full test suite** — executes PHPUnit inside the `tests-cli` container against the isolated test database.

   ```bash
   npm run test:php
   ```

## Creating a test file

Drop a `.php` file in `tests/php/`. PHPUnit discovers it automatically — no registration needed.

```php
<?php
/**
 * [What this class tests]
 */
class MyFeatureTest extends WP_UnitTestCase {

    public function test_[describes_the_expected_behaviour](): void {
        // arrange
        // act
        // assert
    }
}
```

**Conventions:**
- No namespace — standard WordPress testing convention
- One class per file; filename must match the class name (`MyFeatureTest.php`)
- Method names describe the expected behaviour: `test_filter_appends_suffix`, `test_meta_is_saved`

## Factories — creating WordPress data

Use `self::factory()` to create posts, users, terms, and comments. Never insert raw SQL. Database state is rolled back automatically between every test.

```php
$post_id = self::factory()->post->create( [ 'post_status' => 'publish' ] );
$user_id = self::factory()->user->create( [ 'role' => 'editor' ] );
$term_id = self::factory()->term->create( [ 'taxonomy' => 'category' ] );
```

## Hooks and filters

Register hooks inside the test method, not in `setUp` — they are cleaned up automatically after each test.

```php
add_filter( 'demo_plugin/my_filter', fn( $v ) => $v . '-modified' );
$result = apply_filters( 'demo_plugin/my_filter', 'original' );
$this->assertSame( 'original-modified', $result );
```

## Plugin dependencies

If the code under test requires another plugin, install it in the test container by extending `afterStart` in `.wp-env.json`:

```json
{
    "lifecycleScripts": {
        "afterStart": "<existing_commands> && wp-env run tests-cli wp plugin install <plugin-slug> --activate"
    }
}
```

Restart with `npm run env:start` after editing `.wp-env.json`. See `references/testing.mdx` for details and a concrete example.

登录后下载/点赞/收藏 ❤ 8 | ★ 0

application-testing

目录结构

SKILL.md

举报内容

提示