browner12/helpers

通用助手

v3.6.0 2024-03-14 18:54 UTC

README

Latest Version on Packagist Software License Build Status Coverage Status Quality Score Total Downloads

这是一个助手包,提供了一些内置助手,同时也提供 Artisan 生成器,可以快速创建您自己的自定义助手。

安装

通过 Composer

$ composer require browner12/helpers

配置

将服务提供者添加到 config/app.php 文件中的 providers 数组中。

'providers' => [
    browner12\helpers\HelperServiceProvider::class,
];

如果您使用 Laravel 的自动包发现,可以跳过此步骤。

发布

您可以一次性发布所有内容

php artisan vendor:publish --provider="browner12\helpers\HelperServiceProvider"

或者可以单独发布组。

php artisan vendor:publish --provider="browner12\helpers\HelperServiceProvider" --tag="config"

使用方法

此包附带了一些内置助手,您可以选择是否使用。默认情况下,所有这些助手对您的应用程序都是不活动的。要调整哪些助手是活动的,哪些是不活动的,请打开 config/helpers.php 文件,并找到 package_helpers 选项。将您希望激活的任何助手添加到该键中。查看源代码以查看每个助手包含哪些函数以及每个函数做什么。

您还可以创建自己的自定义助手,以包含到您的应用程序中。Artisan 生成器可以帮助您快速创建应用程序的新助手。

php artisan make:helper MyHelper

您的自定义助手将被放置在 app/Helpers 目录中,除非您在配置中覆盖了默认目录。

默认情况下,服务提供者使用 glob 函数自动要求 'Helpers' 目录中的任何 PHP 文件。如果您更喜欢基于映射的方法,您可以在配置文件中编辑 custom_helpers,并包括您希望激活的任何自定义目录中的助手文件名。在新助手内部,定义您自己的自定义函数,这些函数将在整个应用程序中可用。

if (!function_exists('hello')) {

    /**
     * say hello
     *
     * @param string $name
     * @return string
     */
    function hello($name)
    {
        return 'Hello ' . $name . '!';
    }
}

变更日志

请参阅 CHANGELOG 以获取更多有关最近更改的信息。

测试

$ composer test

贡献

请参阅 CONTRIBUTINGCONDUCT 以获取详细信息。

安全性

如果您发现任何与安全相关的问题,请通过电子邮件 browner12@gmail.com 联系,而不是使用问题跟踪器。

致谢

许可

MIT 许可证(MIT)。请参阅 许可文件 以获取更多信息。