README

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

安装

通过 Composer

$ composer require hooshid/laravel-helpers

设置

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

'providers' => [
    Hooshid\Helpers\HelperServiceProvider::class,
];

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

发布

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

php artisan vendor:publish --provider="Hooshid\Helpers\HelperServiceProvider"

或者您可以单独发布组。

php artisan vendor:publish --provider="Hooshid\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 . '!';
    }
}

可用函数

新函数始终在添加。请随意贡献。

格式化器

get_excerpt()

获取文本的摘要

get_excerpt($text, $maxChars = null, $suffix = '...', $br = true, $clean_html = true);

format_bytes()

将字节数格式化为千字节、兆字节、吉字节或太字节

format_bytes($bytes, $precision = 2);

clean_string()

从输入中删除 HTML 标签

clean_string($value, $functions = null);

phone()

电话格式化器（伊朗移动电话和家庭电话号码）

phone($phone);

图片

image()

如果为空则提供默认图片

$image = image('/images/test.jpg');

// /images/test.jpg

gravatar()

提供 Gravatar 图片（如果您的应用程序使用 Laravel 认证，当运行带有 null 值的函数时，函数尝试使用 auth()->user()->email 获取用户电子邮件）

$gravatar = gravatar('email@gmail.com');

字符串

str_lower()

将字符串转换为小写，假设它使用的是 UTF-8 编码

$lower = str_lower('TeSt');

// test

str_upper()

将字符串转换为大写，假设它使用的是 UTF-8 编码

$upper = str_upper('TeSt');

// TEST

变更日志

有关最近更改的更多信息，请参阅变更日志。

许可

MIT 许可证（MIT）。有关更多信息，请参阅许可文件。