fix: 修复 fail 函数错误码问题

Author: mouyong

.editorconfig

@@ -0,0 +1,20 @@
+root = true
+
+[*]
+indent_style = space
+indent_size = 4
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = false
+
+[*.{vue,js,scss}]
+charset = utf-8
+indent_style = space
+indent_size = 2
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.md]
+trim_trailing_whitespace = false

.gitattributes

@@ -0,0 +1,11 @@
+* text=auto
+
+/tests export-ignore
+.gitattributes export-ignore
+.gitignore export-ignore
+.scrutinizer.yml export-ignore
+.travis.yml export-ignore
+phpunit.php export-ignore
+phpunit.xml.dist export-ignore
+phpunit.xml export-ignore
+.php_cs export-ignore

.gitignore

@@ -0,0 +1,8 @@
+.idea
+*.DS_Store
+/vendor
+/coverage
+sftp-config.json
+composer.lock
+.subsplit
+.php_cs.cache

.php_cs

@@ -0,0 +1,27 @@
+<?php
+$header = <<<EOF
+This file is part of the zhenmu/support.
+
+(c) mouyong <[email protected]>
+
+This source file is subject to the MIT license that is bundled.
+EOF;
+
+return PhpCsFixer\Config::create()
+    ->setRiskyAllowed(true)
+    ->setRules(array(
+        '@Symfony' => true,
+        'header_comment' => array('header' => $header),
+        'array_syntax' => array('syntax' => 'short'),
+        'ordered_imports' => true,
+        'no_useless_else' => true,
+        'no_useless_return' => true,
+        'php_unit_construct' => true,
+        'php_unit_strict' => true,
+    ))
+    ->setFinder(
+        PhpCsFixer\Finder::create()
+            ->exclude('vendor')
+            ->in(__DIR__)
+    )
+;

LaravelReadme.md

@@ -0,0 +1,132 @@
+<h1 style="text-align: center;"> support </h1>
+
+## 安装
+
+```shell
+$ composer require zhenmu/support -vvv
+```
+
+## 使用
+
+1. 通过 `php artisan make:controller` 控制器生成后，继承同目录下的 `Controller` 基类.
+2. 编写接口时可通过 `$this->success($data = [], $err_code = 200, $messsage = 'success');` 返回正确数据给接口.
+3. 编写接口时可通过 `$this->fail($messsage = '', $err_code = 400);` 返回错误信息给接口.
+4. 在 `app/Exceptions/Handler.php` 的 `register` 函数中, 注册 `ResponseTrait` 的 `renderableHandle`, 示例见下方错误处理.
+
+
+### 控制器
+
+```php
+<?php
+
+namespace App\Http\Controllers;
+
+use Illuminate\Foundation\Auth\Access\AuthorizesRequests;
+use Illuminate\Foundation\Bus\DispatchesJobs;
+use Illuminate\Foundation\Validation\ValidatesRequests;
+use Illuminate\Routing\Controller as BaseController;
+use ZhenMu\Support\Traits\ResponseTrait; // here
+
+class Controller extends BaseController
+{
+    use AuthorizesRequests, DispatchesJobs, ValidatesRequests;
+    use ResponseTrait; // here
+}
+
+```
+
+
+### 错误处理
+
+```php
+<?php
+
+namespace App\Exceptions;
+
+use Illuminate\Foundation\Exceptions\Handler as ExceptionHandler;
+use Throwable;
+use ZhenMu\Support\Traits\ResponseTrait; // here
+
+class Handler extends ExceptionHandler
+{
+    use ResponseTrait; // here
+
+    /**
+     * A list of exception types with their corresponding custom log levels.
+     *
+     * @var array<class-string<\Throwable>, \Psr\Log\LogLevel::*>
+     */
+    protected $levels = [
+        //
+    ];
+
+    /**
+     * A list of the exception types that are not reported.
+     *
+     * @var array<int, class-string<\Throwable>>
+     */
+    protected $dontReport = [
+        //
+    ];
+
+    /**
+     * A list of the inputs that are never flashed for validation exceptions.
+     *
+     * @var array<int, string>
+     */
+    protected $dontFlash = [
+        'current_password',
+        'password',
+        'password_confirmation',
+    ];
+
+    /**
+     * Register the exception handling callbacks for the application.
+     *
+     * @return void
+     */
+    public function register()
+    {
+        $this->reportable(function (Throwable $e) {
+            //
+        });
+        
+        $this->renderable($this->renderableHandle()); // here
+    }
+}
+
+```
+
+## 控制器调用
+
+```
+<?php
+
+namespace App\Http\Controllers;
+
+use Illuminate\Http\Request;
+
+class DemoController extends Controller
+{
+    public function index()
+    {
+        // validate data
+        \validator()->validate(\request(), [
+            'name' => 'required|string',
+            'age' => 'nullable|integer',
+        ]);
+
+        // your business logic
+        $error = false;
+        if ($error) { // here business logic error.
+            throw new \RuntimeException('error message');
+        }
+
+        return $this->success([ // here response success
+            'key1' => 'value1',
+            'key2' => 'value2',
+        ]);
+    }
+}
+
+```

README.md

@@ -0,0 +1,20 @@
+<h1 style="text-align: center;"> support </h1>
+
+## 简介
+
+php 基础支持，详细内容见 `src/Utils`、`src/Traits` 目录。
+
+项目自动拆分，如需跟踪源码更新情况，请前往：https://github.com/plugins-world/packages 查看 PhpSupport 目录
+
+
+## 安装
+
+```shell
+$ composer require zhenmu/support -vvv
+```
+
+
+## 使用
+
+- [laravel 使用示例](/LaravelReadme.md)
+- [webman 使用示例](/WebmanReadme.md)

WebmanReadme.md

@@ -0,0 +1,83 @@
+<h1 style="text-align: center;"> support </h1>
+
+## 安装
+
+```shell
+$ composer require zhenmu/support -vvv
+```
+
+## 使用
+
+1. 通过 `./webman make:controller` 控制器生成后，继承同目录下的 `WebmanBaseController` 基类。
+2. 编写接口时可通过 `$this->success($data = [], $err_code = 200, $messsage = 'success');` 返回正确数据给接口。
+3. 编写接口时可通过 `$this->fail($messsage = '', $err_code = 400);` 返回错误信息给接口。
+4. 在 `support/exception/Handler.php` 的 `render` 函数中，调用 `WebmanResponseTrait` 的 `$this->renderableHandle($request, $exception);` 示例见下方错误处理。
+
+
+### 控制器
+
+```php
+<?php
+
+namespace support\exception;
+
+use Webman\Http\Request;
+use Webman\Http\Response;
+use Throwable;
+use Webman\Exception\ExceptionHandler;
+use ZhenMu\Support\Traits\WebmanResponseTrait;
+
+/**
+ * Class Handler
+ * @package support\exception
+ */
+class Handler extends ExceptionHandler
+{
+    use WebmanResponseTrait; // 这里需要引入 WebmanResponseTrait
+
+    public $dontReport = [
+        BusinessException::class,
+    ];
+
+    public function report(Throwable $exception)
+    {
+        parent::report($exception);
+    }
+
+    public function render(Request $request, Throwable $exception): Response
+    {
+        return $this->renderableHandle($request, $exception); // 这里进行调用，做了一些错误捕捉
+    }
+}
+```
+
+## 控制器调用
+
+```
+<?php
+
+namespace app\controller;
+
+class DemoController extends WebmanBaseController
+{
+    public function index()
+    {
+        // validate data
+        \validator()->validate(\request(), [
+            'name' => 'required|string',
+            'age' => 'nullable|integer',
+        ]);
+
+        // your logic
+        $error = false;
+        if ($error) {
+            throw new \RuntimeException('error message');
+        }
+
+        return $this->success([
+            'key1' => 'value1',
+            'key2' => 'value2',
+        ]);
+    }
+}
+```

composer.json

@@ -0,0 +1,37 @@
+{
+    "name": "zhenmu/support",
+    "description": "Php 代码扩展包, 一些常用的 php 代码封装",
+    "keywords": ["support", "mouyong", "zhenmu", "laravel", "webman", "aes", "php", "composer", "xml", "uuid", "url", "state", "file", "tool", "utils", "util"],
+    "license": "MIT",
+    "authors": [
+        {
+            "name": "mouyong",
+            "email": "[email protected]",
+            "homepage": "https://github.com/mouyong",
+            "role": "Creator & Developer"
+        }
+    ],
+    "support": {
+        "issues": "https://github.com/plugins-world/php-support/issues",
+        "source": "https://github.com/plugins-world/php-support",
+        "homepage": "https://laravel-workerman.iwnweb.com/d/22-php-composer"
+    },
+    "require": {
+        "ext-json": "*",
+        "ext-openssl": "*",
+        "ext-fileinfo": "*",
+        "ext-simplexml": "*",
+        "league/fractal": "^0.20.1",
+        "ramsey/uuid": "*",
+        "symfony/process": "*",
+        "nelexa/zip": "^4.0"
+    },
+    "autoload": {
+        "files": [
+            "src/helpers.php"
+        ],
+        "psr-4": {
+            "ZhenMu\\Support\\": "src"
+        }
+    }
+}

examples/example_rsa_chunk.php

@@ -0,0 +1,43 @@
+<?php
+
+// 定义 RSA 加密的密钥长度
+define("KEY_SIZE", 2048);
+
+// 生成 RSA 加密的公钥和私钥
+$res = openssl_pkey_new(array(
+    "private_key_bits" => KEY_SIZE,
+    "private_key_type" => OPENSSL_KEYTYPE_RSA,
+));
+
+// 将私钥转换为字符串
+openssl_pkey_export($res, $privateKey);
+
+// 从私钥中得到公钥
+$publicKey = openssl_pkey_get_details($res)["key"];
+
+// 需要加密的数据
+$plaintext = "Hello, World!";
+
+// RSA 加密，将需要加密的数据按照最大加密长度分块
+$chunkSize = KEY_SIZE / 8 - 11;
+$output = "";
+while ($plaintext) {
+    $chunk = substr($plaintext, 0, $chunkSize);
+    $plaintext = substr($plaintext, $chunkSize);
+    openssl_public_encrypt($chunk, $encrypted, $publicKey);
+    $output .= $encrypted;
+}
+
+// 对 RSA 加密后的数据进行解密
+$plaintext = "";
+while ($output) {
+    $chunk = substr($output, 0, KEY_SIZE / 8);
+    $output = substr($output, KEY_SIZE / 8);
+    openssl_private_decrypt($chunk, $decrypted, $privateKey);
+    $plaintext .= $decrypted;
+}
+
+// 输出解密后的数据
+echo $plaintext;
+
+?>