feat: format

Author: liutao

.php-cs-fixer.php

@@ -2,217 +2,103 @@
 
 declare(strict_types=1);
 
-return (new PhpCsFixer\Config())
+use PhpCsFixer\Config;
+use PhpCsFixer\Finder;
+
+return (new Config())
     ->setRiskyAllowed(true)
     ->setRules([
         '@PSR2' => true,
         '@Symfony' => true,
         '@DoctrineAnnotation' => true,
         '@PhpCsFixer' => true,
-        'global_namespace_import' => [
-            'import_classes' => true,
-            'import_constants' => true,
-            'import_functions' => null,
+        'array_syntax' => [
+            'syntax' => 'short',
         ],
-        'array_indentation' => true,
-        'array_syntax' => ['syntax' => 'short'],
-        'binary_operator_spaces' => [
-            'default' => 'single_space',
+        'list_syntax' => [
+            'syntax' => 'short',
+        ],
+        'concat_space' => [
+            'spacing' => 'one',
         ],
-        'blank_line_after_namespace' => true,
-        'blank_line_after_opening_tag' => true,
         'blank_line_before_statement' => [
             'statements' => [
-                'continue',
-                'return',
+                'declare',
             ],
         ],
-        'blank_lines_before_namespace' => true,
-        'control_structure_braces' => true,
-        'control_structure_continuation_position' => [
-            'position' => 'same_line',
-        ],
-        'curly_braces_position' => [
-            'control_structures_opening_brace' => 'same_line',
-            'functions_opening_brace' => 'next_line_unless_newline_at_signature_end',
-            'anonymous_functions_opening_brace' => 'same_line',
-            'classes_opening_brace' => 'next_line_unless_newline_at_signature_end',
-            'anonymous_classes_opening_brace' => 'next_line_unless_newline_at_signature_end',
-            'allow_single_line_empty_anonymous_classes' => false,
-            'allow_single_line_anonymous_functions' => false,
-        ],
-        'cast_spaces' => true,
-        'class_attributes_separation' => [
-            'elements' => [
-                'const' => 'one',
-                'method' => 'one',
-                'property' => 'one',
-                'trait_import' => 'none',
+        'general_phpdoc_annotation_remove' => [
+            'annotations' => [
+                'author',
             ],
         ],
-        'class_definition' => [
-            'multi_line_extends_each_single_line' => true,
-            'single_item_single_line' => true,
-            'single_line' => true,
-        ],
-        'clean_namespace' => true,
-        'compact_nullable_typehint' => true,
-        'concat_space' => [
-            'spacing' => 'one',
+        'ordered_imports' => [
+            'imports_order' => [
+                'class', 'function', 'const',
+            ],
+            'sort_algorithm' => 'alpha',
         ],
-        'constant_case' => ['case' => 'lower'],
-        'declare_equal_normalize' => true,
-        'declare_parentheses' => true,
-        'elseif' => true,
-        'encoding' => true,
-        'full_opening_tag' => true,
-        'fully_qualified_strict_types' => true,
-        'function_declaration' => true,
-        'general_phpdoc_tag_rename' => true,
-        'heredoc_to_nowdoc' => true,
-        'include' => true,
-        'increment_style' => ['style' => 'post'],
-        'indentation_type' => true,
-        'integer_literal_case' => true,
-        'lambda_not_used_import' => true,
-        'linebreak_after_opening_tag' => true,
-        'line_ending' => true,
-        'list_syntax' => true,
-        'lowercase_cast' => true,
-        'lowercase_keywords' => true,
-        'lowercase_static_reference' => true,
-        'magic_method_casing' => true,
-        'magic_constant_casing' => true,
-        'method_argument_space' => [
-            'on_multiline' => 'ignore',
+        'yoda_style' => [
+            'always_move_variable' => false,
+            'equal' => false,
+            'identical' => false,
         ],
-        'method_chaining_indentation' => true,
         'multiline_whitespace_before_semicolons' => [
             'strategy' => 'no_multi_line',
         ],
-        'native_function_casing' => true,
-        'native_function_type_declaration_casing' => true,
-        'no_alias_functions' => true,
-        'no_alias_language_construct_call' => true,
-        'no_alternative_syntax' => true,
-        'no_binary_string' => true,
-        'no_blank_lines_after_class_opening' => true,
-        'no_blank_lines_after_phpdoc' => true,
-        'no_closing_tag' => true,
-        'no_empty_phpdoc' => true,
-        'no_empty_statement' => true,
+        'constant_case' => [
+            'case' => 'lower',
+        ],
+        'class_attributes_separation' => true,
+        'combine_consecutive_unsets' => true,
+        // 注释结尾是否必须要加句号
+        'phpdoc_summary' => false,
+        // 文件严格模式
+        'declare_strict_types' => true,
+        'linebreak_after_opening_tag' => true,
+        'lowercase_static_reference' => true,
         'no_extra_blank_lines' => [
             'tokens' => [
+                'attribute',
+                'break',
+                'case',
+                'continue',
+                'curly_brace_block',
+                'default',
                 'extra',
+                'parenthesis_brace_block',
+                'return',
+                'square_brace_block',
+                'switch',
                 'throw',
-                'use',
+                'use'
             ],
         ],
-        'no_leading_import_slash' => true,
-        'no_leading_namespace_whitespace' => true,
-        'no_mixed_echo_print' => [
-            'use' => 'echo',
-        ],
-        'no_multiline_whitespace_around_double_arrow' => true,
-        'no_multiple_statements_per_line' => true,
-        'no_short_bool_cast' => true,
-        'no_singleline_whitespace_before_semicolons' => true,
-        'no_spaces_after_function_name' => true,
-        'no_space_around_double_colon' => true,
-        'no_spaces_around_offset' => [
-            'positions' => ['inside', 'outside'],
-        ],
-        'no_spaces_inside_parenthesis' => true,
-        'no_superfluous_phpdoc_tags' => [
-            'allow_mixed' => true,
-            'allow_unused_params' => true,
-        ],
-        'no_trailing_comma_in_singleline' => true,
-        'no_trailing_whitespace' => true,
-        'no_trailing_whitespace_in_comment' => true,
-        'no_unneeded_control_parentheses' => [
-            'statements' => ['break', 'clone', 'continue', 'echo_print', 'return', 'switch_case', 'yield'],
+        'single_line_comment_style' => [
+            'comment_types' => [
+            ],
         ],
-        'no_unneeded_curly_braces' => true,
-        'no_unset_cast' => true,
+        'no_useless_else' => true,
         'no_unused_imports' => true,
-        'no_unreachable_default_argument_value' => true,
-        'no_useless_return' => true,
-        'no_whitespace_before_comma_in_array' => true,
-        'no_whitespace_in_blank_line' => true,
-        'normalize_index_brace' => true,
         'not_operator_with_successor_space' => true,
-        'nullable_type_declaration' => true,
-        'nullable_type_declaration_for_default_null_value' => [
-            'use_nullable_type_declaration' => false,
-        ],
-        'object_operator_without_whitespace' => true,
-        'ordered_imports' => ['sort_algorithm' => 'alpha'],
-        'psr_autoloading' => false,
-        'phpdoc_indent' => true,
-        'phpdoc_inline_tag_normalizer' => true,
-        'phpdoc_no_access' => true,
-        'phpdoc_no_package' => true,
-        'phpdoc_no_useless_inheritdoc' => true,
-        'phpdoc_order' => [
-            'order' => ['param', 'return', 'throws'],
-        ],
-        'phpdoc_scalar' => true,
-        'phpdoc_separation' => [
-            'groups' => [
-                ['deprecated', 'link', 'see', 'since'],
-                ['author', 'copyright', 'license'],
-                ['category', 'package', 'subpackage'],
-                ['property', 'property-read', 'property-write'],
-                ['param', 'return'],
-            ],
-        ],
-        'phpdoc_single_line_var_spacing' => true,
-        'phpdoc_summary' => false,
-        'phpdoc_to_comment' => false,
-        'phpdoc_tag_type' => [
-            'tags' => [
-                'inheritdoc' => 'inline',
-            ],
-        ],
-        'phpdoc_trim' => true,
-        'phpdoc_types' => true,
-        'phpdoc_var_without_name' => true,
-        'return_type_declaration' => ['space_before' => 'none'],
-        'self_accessor' => false,
-        'self_static_accessor' => true,
-        'short_scalar_cast' => true,
-        'simplified_null_return' => false,
-        'single_blank_line_at_eof' => true,
-        'single_class_element_per_statement' => [
-            'elements' => ['const', 'property'],
-        ],
-        'single_import_per_statement' => true,
-        'single_line_after_imports' => true,
-        'single_line_comment_style' => [
-            'comment_types' => ['hash'],
-        ],
+        // 全局命名空间导入
+        'global_namespace_import' => true,
+        'not_operator_with_space' => false,
+        'ordered_class_elements' => true,
+        'php_unit_strict' => false,
+        'phpdoc_separation' => false,
         'single_quote' => true,
-        'single_space_around_construct' => true,
-        'space_after_semicolon' => true,
         'standardize_not_equals' => true,
-        'statement_indentation' => true,
-        'switch_case_semicolon_to_colon' => true,
-        'switch_case_space' => true,
-        'ternary_operator_spaces' => true,
-        'trailing_comma_in_multiline' => ['elements' => ['arrays']],
-        'trim_array_spaces' => true,
-        'type_declaration_spaces' => true,
-        'types_spaces' => true,
-        'unary_operator_spaces' => true,
-        'visibility_required' => [
-            'elements' => ['method', 'property'],
-        ],
-        'whitespace_after_comma_in_array' => true,
-    ])->setFinder(
-        PhpCsFixer\Finder::create()
+        'multiline_comment_opening_closing' => true,
+    ])
+    ->setFinder(
+        Finder::create()
+            ->exclude('bin')
             ->exclude('public')
             ->exclude('runtime')
             ->exclude('vendor')
+            ->exclude('database/migrations')
+            ->exclude('database/seeders')
             ->in(__DIR__)
-    );
+    )
+    ->setUsingCache(true)
+    ->setCacheFile(__DIR__ . '/.php-cs-fixer.cache');

app/Controller/IndexController.php

@@ -6,6 +6,7 @@
 
 use App\Dto\Request\IndexGetReq;
 use App\Dto\Response\IndexGetRes;
+use App\Util\JsonResponse;
 use MicroPHP\Framework\Controller;
 use MicroPHP\Framework\Http\Response;
 use MicroPHP\Framework\Http\ServerRequest;
@@ -27,7 +28,7 @@ class IndexController extends Controller
 
     #[Get(summary: '首页', tags: [self::TAG])]
     #[SuccessJsonResponse(ref: IndexGetRes::class)]
-    public function index(ServerRequest $request): Response
+    public function index(): Response
     {
         return $this->json('Hello World');
     }
@@ -37,6 +38,10 @@ public function index(ServerRequest $request): Response
     #[SuccessJsonResponse(ref: IndexGetRes::class)]
     public function get(ServerRequest $request): Response
     {
-        return $this->json(new IndexGetRes(['id' => $request->input('id'), 'name' => 'hello']));
+        $param = IndexGetReq::fromRequest($request);
+
+        return $this->json(
+            JsonResponse::success(new IndexGetRes(['id' => $param->id, 'name' => 'hello']))
+        );
     }
 }

app/Dto/Request/IndexGetReq.php

@@ -1,15 +1,18 @@
 <?php
+
 declare(strict_types=1);
 
 namespace App\Dto\Request;
 
-use MicroPHP\Data\Data;
+use MicroPHP\Framework\Dto\Request\BaseReq;
 use MicroPHP\Swagger\Schema\Property;
 use MicroPHP\Swagger\Schema\Schema;
+use Symfony\Component\Validator\Constraints\Positive;
 
 #[Schema(title: 'index请求参数')]
-class IndexGetReq extends Data
+class IndexGetReq extends BaseReq
 {
     #[Property(title: 'ID', example: 1)]
-    public int $id = 1;
-}
+    #[Positive(message: 'ID必须为正整数')]
+    public int $id;
+}

app/Dto/Response/IndexGetRes.php

@@ -1,4 +1,5 @@
 <?php
+
 declare(strict_types=1);
 
 namespace App\Dto\Response;
@@ -15,4 +16,4 @@ class IndexGetRes extends Data
 
     #[Property(title: '名字', example: 'test')]
     public string $name;
-}
+}

app/Enum/StatusEnum.php

@@ -0,0 +1,24 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Enum;
+
+use MicroPHP\Contract\Enum\Attributes\EnumClass;
+use MicroPHP\Contract\Enum\Attributes\EnumProperty;
+use MicroPHP\Contract\Enum\EnumHelper;
+
+#[EnumClass(name: '状态码枚举类')]
+enum StatusEnum: int
+{
+    use EnumHelper;
+
+    #[EnumProperty(label: 'success')]
+    case SUCCESS = 200;
+
+    #[EnumProperty(label: 'bad request')]
+    case BAD_REQUEST = 400;
+
+    #[EnumProperty(label: 'system error')]
+    case ERROR = 500;
+}