chore: 将 enum 目录下的模块统一移动到 packages 目录

Author: tourze-ci

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 tourze
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,147 @@
+# AopBundle
+
+[![Latest Version](https://img.shields.io/packagist/v/tourze/symfony-aop-bundle.svg?style=flat-square)](https://packagist.org/packages/tourze/symfony-aop-bundle)
+
+[English](README.md) | [中文](README.zh-CN.md)
+
+## Overview
+
+AopBundle is a Symfony bundle that implements Aspect-Oriented Programming (AOP) using PHP 8's Attribute features. It enables adding cross-cutting concerns (like logging, caching, transactions) to your code without modifying the core logic.
+
+## Requirements
+
+- PHP 8.1+
+- Symfony 6.4+
+
+## Installation
+
+```bash
+composer require tourze/symfony-aop-bundle
+```
+
+## Features
+
+- Define aspects using PHP 8 attributes
+- Support for multiple advice types (Before, After, AfterReturning, AfterThrowing)
+- Join point context with access to method parameters and return values
+- Powerful pointcut expressions for targeting specific services/methods
+- Built-in stopwatch support for performance monitoring
+- Exception handling capabilities
+
+## Basic Usage
+
+### 1. Define an Aspect
+
+Create a class with the `#[Aspect]` attribute and define advice methods:
+
+```php
+<?php
+
+namespace App\Aspect;
+
+use Tourze\Symfony\Aop\Attribute\Aspect;
+use Tourze\Symfony\Aop\Attribute\Before;
+use Tourze\Symfony\Aop\Model\JoinPoint;
+
+#[Aspect]
+class LoggingAspect
+{
+    #[Before('class.getName() === "App\\Service\\UserService" && method.getName() === "createUser"')]
+    public function logBefore(JoinPoint $joinPoint): void
+    {
+        // Logging logic before method execution
+    }
+}
+```
+
+### 2. Available Advice Types
+
+- `#[Before]` - Executed before the target method
+- `#[After]` - Executed after the target method (regardless of exceptions)
+- `#[AfterReturning]` - Executed after successful method return
+- `#[AfterThrowing]` - Executed when the target method throws an exception
+- `#[CatchException]` - Used for exception handling
+
+### 3. JoinPoint
+
+The `JoinPoint` object provides context for the intercepted method:
+
+```php
+$joinPoint->getInstance();     // The service instance
+$joinPoint->getMethod();       // Method name being executed
+$joinPoint->getParams();       // Method parameters
+$joinPoint->getReturnValue();  // Return value (for after advice)
+$joinPoint->getException();    // Exception (for exception advice)
+$joinPoint->proceed();         // Manually execute the original method
+```
+
+### 4. Pointcut Expressions
+
+Define where advice should be applied:
+
+```php
+// Match by service ID
+#[Before(serviceIds: ['app.user_service'])]
+
+// Match by class attribute
+#[AfterThrowing(classAttribute: CatchException::class)]
+
+// Match by method attribute
+#[After(methodAttribute: SomeAttribute::class)]
+
+// Match by service tags
+#[Before(serviceTags: ['app.loggable'])]
+
+// Match by parent class
+#[Before(parentClasses: [BaseRepository::class])]
+
+// Custom expression
+#[Before('class.getName() === "App\\Service\\UserService"')]
+```
+
+### 5. Performance Monitoring
+
+```php
+use Tourze\Symfony\Aop\Attribute\Stopwatch;
+
+class UserService
+{
+    #[Stopwatch]
+    public function complexOperation()
+    {
+        // Time-consuming operation
+    }
+}
+```
+
+## Best Practices
+
+1. **Keep aspects focused**
+   - Each aspect should have a single responsibility
+   - Avoid heavy operations in advice methods
+
+2. **Advice execution order**
+   - Before advice is executed in declaration order
+   - After/AfterReturning/AfterThrowing advice is executed in reverse order
+
+3. **Performance considerations**
+   - Use AOP only when necessary
+   - Consider the performance impact in production
+   - Use Stopwatch to monitor method execution time
+
+4. **Exception handling**
+   - Be careful with exception handling in advice
+   - Consider using AfterThrowing for exception logging
+   - Use CatchException for controlled exception handling
+
+## Configuration
+
+No additional configuration is required. The bundle automatically detects services with the `#[Aspect]` attribute and applies advice to matching services.
+
+## Contributing
+
+Contributions are welcome. Please feel free to submit a Pull Request.
+
+## License
+
+This bundle is available under the MIT license. See the [LICENSE](LICENSE) file for more information.

README.zh-CN.md

@@ -0,0 +1,147 @@
+# AopBundle
+
+[![Latest Version](https://img.shields.io/packagist/v/tourze/symfony-aop-bundle.svg?style=flat-square)](https://packagist.org/packages/tourze/symfony-aop-bundle)
+
+[English](README.md) | [中文](README.zh-CN.md)
+
+## 概述
+
+AopBundle 是一个基于 Symfony 的 AOP (面向切面编程) 实现包。它通过 PHP 8 的 Attribute 特性提供了声明式的切面编程能力，可以在不修改原有代码的情况下为方法添加横切关注点(如日志、缓存、事务等)。
+
+## 系统要求
+
+- PHP 8.1+
+- Symfony 6.4+
+
+## 安装方法
+
+```bash
+composer require tourze/symfony-aop-bundle
+```
+
+## 主要功能
+
+- 使用 PHP 8 属性定义切面
+- 支持多种通知类型（Before、After、AfterReturning、AfterThrowing）
+- 通过 JoinPoint 获取方法参数和返回值
+- 强大的切点表达式，用于定位特定服务/方法
+- 内置 Stopwatch 支持，用于性能监控
+- 异常处理能力
+
+## 基本使用
+
+### 1. 定义切面
+
+创建一个带有 `#[Aspect]` 属性的类，并定义通知方法：
+
+```php
+<?php
+
+namespace App\Aspect;
+
+use Tourze\Symfony\Aop\Attribute\Aspect;
+use Tourze\Symfony\Aop\Attribute\Before;
+use Tourze\Symfony\Aop\Model\JoinPoint;
+
+#[Aspect]
+class LoggingAspect
+{
+    #[Before('class.getName() === "App\\Service\\UserService" && method.getName() === "createUser"')]
+    public function logBefore(JoinPoint $joinPoint): void
+    {
+        // 方法执行前的日志逻辑
+    }
+}
+```
+
+### 2. 可用的通知类型
+
+- `#[Before]` - 在目标方法执行前执行
+- `#[After]` - 在目标方法执行后执行（无论是否抛出异常）
+- `#[AfterReturning]` - 在目标方法成功返回后执行
+- `#[AfterThrowing]` - 在目标方法抛出异常时执行
+- `#[CatchException]` - 用于异常处理
+
+### 3. JoinPoint
+
+`JoinPoint` 对象提供了被拦截方法的上下文：
+
+```php
+$joinPoint->getInstance();     // 服务实例
+$joinPoint->getMethod();       // 正在执行的方法名
+$joinPoint->getParams();       // 方法参数
+$joinPoint->getReturnValue();  // 返回值（用于 After 通知）
+$joinPoint->getException();    // 异常（用于异常通知）
+$joinPoint->proceed();         // 手动执行原始方法
+```
+
+### 4. 切点表达式
+
+定义通知应该应用的位置：
+
+```php
+// 通过服务 ID 匹配
+#[Before(serviceIds: ['app.user_service'])]
+
+// 通过类属性匹配
+#[AfterThrowing(classAttribute: CatchException::class)]
+
+// 通过方法属性匹配
+#[After(methodAttribute: SomeAttribute::class)]
+
+// 通过服务标签匹配
+#[Before(serviceTags: ['app.loggable'])]
+
+// 通过父类匹配
+#[Before(parentClasses: [BaseRepository::class])]
+
+// 自定义表达式
+#[Before('class.getName() === "App\\Service\\UserService"')]
+```
+
+### 5. 性能监控
+
+```php
+use Tourze\Symfony\Aop\Attribute\Stopwatch;
+
+class UserService
+{
+    #[Stopwatch]
+    public function complexOperation()
+    {
+        // 耗时操作
+    }
+}
+```
+
+## 最佳实践
+
+1. **保持切面专注**
+   - 每个切面应该只有一个责任
+   - 避免在通知方法中执行重量级操作
+
+2. **通知执行顺序**
+   - Before 通知按声明顺序执行
+   - After/AfterReturning/AfterThrowing 通知按声明的逆序执行
+
+3. **性能考虑**
+   - 只在必要时使用 AOP
+   - 考虑在生产环境中的性能影响
+   - 使用 Stopwatch 监控方法执行时间
+
+4. **异常处理**
+   - 在通知中小心处理异常
+   - 考虑使用 AfterThrowing 进行异常日志记录
+   - 使用 CatchException 进行受控异常处理
+
+## 配置
+
+不需要额外配置。该包会自动检测带有 `#[Aspect]` 属性的服务，并将通知应用于匹配的服务。
+
+## 贡献
+
+欢迎贡献。请随时提交 Pull Request。
+
+## 许可证
+
+此包在 MIT 许可下可用。有关更多信息，请参阅 [LICENSE](LICENSE) 文件。

composer.json

@@ -0,0 +1,20 @@
+{
+  "name": "tourze/symfony-aop-bundle",
+  "description": "AOP for Symfony Framework",
+  "license": "MIT",
+  "require": {
+    "php": "^8.1",
+    "friendsofphp/proxy-manager-lts": "^1.0.18",
+    "symfony/console": "^6.4",
+    "symfony/expression-language": "^6.4",
+    "symfony/framework-bundle": "^6.4",
+    "symfony/stopwatch": "^6.4",
+    "symfony/yaml": "^6.4 || ^7.1",
+    "tourze/arrayable": "0.0.*"
+  },
+  "autoload": {
+    "psr-4": {
+      "Tourze\\Symfony\\Aop\\": "src"
+    }
+  }
+}

src/AopBundle.php

@@ -0,0 +1,18 @@
+<?php
+
+namespace Tourze\Symfony\Aop;
+
+use Symfony\Component\DependencyInjection\Compiler\PassConfig;
+use Symfony\Component\DependencyInjection\ContainerBuilder;
+use Symfony\Component\HttpKernel\Bundle\Bundle;
+use Tourze\Symfony\Aop\DependencyInjection\Compiler\AopAttributeCompilerPass;
+
+class AopBundle extends Bundle
+{
+    public function build(ContainerBuilder $container): void
+    {
+        parent::build($container);
+
+        $container->addCompilerPass(new AopAttributeCompilerPass(), PassConfig::TYPE_BEFORE_REMOVING);
+    }
+}

src/Aspect/ExceptionAspect.php

@@ -0,0 +1,20 @@
+<?php
+
+namespace Tourze\Symfony\Aop\Aspect;
+
+use Tourze\Symfony\Aop\Attribute\AfterThrowing;
+use Tourze\Symfony\Aop\Attribute\Aspect;
+use Tourze\Symfony\Aop\Attribute\CatchException;
+use Tourze\Symfony\Aop\Model\JoinPoint;
+
+#[Aspect]
+class ExceptionAspect
+{
+    #[AfterThrowing(classAttribute: CatchException::class)]
+    public function catchException(JoinPoint $joinPoint): void
+    {
+        if ($joinPoint->getException()) {
+            //dump($joinPoint->getException());
+        }
+    }
+}