在Laravel中创建自己的PHP帮助函数

neu 发布于2019-07-01 14:21 / 3422人阅读

摘要：转至应用程序根目录中的命令行并运行以下命令以创建新的服务提供者。将会提示运行结果一旦服务提供者成功创建，打开该文件。现在我们的服务提供者已经完成，我们需要注册我们的服务提供者，所以，会在引导期间加载它。这就是为服务提供者创建你的帮手。

Laravel 为我们提供了许多内置的帮助函数，你可以在应用程序中的任何位置调用它。它们使你可以方便地处理数组和对象，路径，字符串，URL和其他类型的工作流。

尽管在 Laravel 核心中定义了许多帮助函数，但你可以在 Laravel 中定义自己的帮助函数以避免重复相同的代码。它确保你的应用程序有更好的可维护性。

我们来看看如何创建自己的定制 Laravel 帮助函数

Laravel 中的帮助函数

Laravel 中有许多内置的帮助程序可供你的应用程序使用。它们根据它们提供的功能类型进行分组。这是一个完整的内置 Laravel 帮助文件。

数组和对象

在这个组中，助手提供了处理数组和对象的能力。该组包含用于添加两个数组的辅助函数，将多维数组折叠成单个数组，返回数组的第一个元素，检查数组中是否存在给定的项目或项目，并执行许多其他类型的操作。

路径

这组helper返回Laravel应用程序中不同目录的绝对路径，例如 app，config，public，resource，storage和你的应用程序的基本路径。

字符串

该组中的助手使用字符串操作。你可以将字符串转换为骆驼大小写，找到该类的基本名称，运行 htmlspecialchars，将文本转换为kebab大小写，将文本转换为大小写，并执行许多其他类型的字符串操作。

URL

助手的URLs组与生成URL一起工作。你可以为控制器操作生成URL，命名为route，以及指定路径的完全限定URL。

杂项

这类帮助程序包含处理页面状态，服务容器，认证，缓存等功能。

在Laravel中创建帮助文件

在本节中，我们将通过创建Laravel帮助程序文件，该文件可以在Laravel应用程序中全局使用。你可以组织你的帮助程序文件的位置，但是，我更愿意将我的Laravel项目帮助程序文件保存在 app/Helpers/Helper.php 中。在本教程中，我们将在我想要的位置创建一个帮助文件。

创建一个帮助文件

你可以将你的帮助程序文件放在你的Laravel应用程序的任何位置，将它放在你的应用程序目录下是标准的。
让我们在app下创建一个 Helpers 目录并创建一个 Helper.php 文件。这些是该文件的以下内容。


如果你正在使用一个类并且它的方法是你的助手，你可以用命名空间声明来启动这个文件。
namespace AppHelpers;
如果你不使用命名空间声明，则这些函数将变为全局可用，你甚至可以在不指定名称空间的情况下使用它们。 所有Laravel内置的帮助函数都是在没有命名空间的情况下定义的。 此外，助手类也将在全局范围内提供。 因此，如果你想在不指定命名空间的情况下使用助手，只需删除这一行。
定义这些函数时有一些注意事项。所有的Laravel助手文件函数都会被检查以避免函数定义冲突。
if (!function_exists("human_file_size")) {
    function human_file_size($bytes, $decimals = 2)
    {
        // ...
    }
}
如果跳过此检查，则每次重新定义具有相同定义的函数时都会发生冲突。你可以使用这个检查，或者你也可以用你的函数名称作为前缀来避免冲突。
使用帮助文件
现在，就我们的帮助文件而言，就是这样。让我们看看如何在Laravel应用程序中使用助手文件。

你可以使用 composer 自动加载助手文件。然后，你可以在应用程序的任何位置使用这些功能。
你也可以使用Laravel服务提供者注册此文件。 Laravel会将其与其他依赖关系一起加载。
你也可以使用一个包含所有这些功能的软件包。

让我们看看如何使用所有这些方法。
通过Composer自动加载
第一个非常简单直接。 只需转到位于Laravel项目中的 composer.json 文件，你将看到自动加载 key。 Composer 有一个key files（你想自动加载的文件路径数组），你可以在自动 `autoload 中使用它。 如：
"autoload": {
    "files": [
        "app/Helpers/Helper.php"
    ],
    "classmap": [
        "database/seeds",
        "database/factories"
    ],
    "psr-4": {
        "App": "app/"
    }
},
更改composer.json文件并向文件数组添加新路径后，需要重新生成自动加载文件。只需从Laravel项目目录中的终端运行此命令即可。
composer dump-autoload
现在，你的帮助程序文件将自动加载到你的Laravel项目中。
通过服务提供者加载
让我们来看看如何使用服务提供者来自动加载助手文件。转至应用程序根目录中的命令行并运行以下命令以创建新的服务提供者。
php artisan make:provider HelperServiceProvider
将会提示运行结果
Provider created successfully.
一旦服务提供者成功创建，打开该文件。在注册方法中添加你的助手文件。
public function register()
{
    $file = app_path("Helpers/Helper.php");
    if (file_exists($file)) {
        require_once($file);
    }
}
在注册方法中，我们包含了我们的依赖关系。 在大型项目中，你可能在目录中有多个帮助程序文件，并且你想要全部这些文件。 你可以更改注册方法，如下所示，你的服务提供商将加载Helpers目录中的所有文件。
public function register()
{
    foreach (glob(app_path() . "/Helpers/*.php") as $file) {
        require_once($file);
    }
}
它将需要 app/Helpers 目录中的所有文件。
现在我们的服务提供者已经完成，我们需要注册我们的服务提供者，所以，Laravel会在引导期间加载它。 为此，请转至 config/app.php 并在结尾处的 providers 数组中添加以下行。
AppProvidersHelperServiceProvider::class,
如果你的帮助文件涉及到一个拥有这些帮助方法的类，并且你已经指定了命名空间，那么你可以通过定义一个别名来毫不费力地使用它们。 您可以通过在 config/app.php 文件中的别名数组末尾添加以下内容轻松完成此操作。
"Helper" => AppHelpersHelper::class,
通过将这添加到别名数组中，你将能够使用Helper关键字调用助手。这就是为服务提供者创建你的帮手。
使用第三方包加载
你也可以使用第三方package: Laravel helpers package。你可以通过在控制台中从你的应用程序的根目录运行此命令来通过编写器安装它。
composer require browner12/helpers
在 config/app.php 中的 providers 数组中添加以下行
browner12helpersHelperServiceProvider::class,
如果你正在使用Laravel的自动包发现功能，则可以跳过此步骤。 完成必要的步骤之后，你可以使用此命令创建助手文件。
php artisan make:helper Helper
它将在 AppHelpers 中创建一个 Helper.php 文件，你可以轻松添加所有帮助程序功能。
Helper 的具体使用
现在我们的函数在Helper文件中定义，没有定义名称空间，我们可以很容易地使用它们。 只需在 routes/web.php 中找到你的路由文件，并将此功能用于首页。 例如，这是完整的 routes/web.php 文件：

它将简单地返回作为参数传递的字节数的可读大小。你可以从任何地方控制器或视图调用这些函数。
资源

查看所有可用的 内置Laravel助手

一个简单的包来创建助手文件 browner12/helpers

了解有关使用 Composer Autoloader 的更多信息

欢迎留言讨论。
更多PHP相关，请前往PHPCasts

文章版权归作者所有，未经允许请勿转载,若此文章存在违规行为，您可以联系管理员删除。

转载请注明本文地址：https://www.ucloud.cn/yun/31992.html

[译] 使用 Sami 生成 PHP 文档

摘要：原文地址为方法类函数生成文档已经成为了程序员的习惯所以需要知道通过源代码生成独立的文档本文中我会介绍一款新的文档生成工具什么是是插入到类接口方法属性顶部的多行注释为了阐明这个我们看下中的代码片段开始于结束于每行之间使用当定义一个类属性或者原文地址: Generating PHP Documentation with Sami 为方法, 类, 函数生成文档已经成为了程序员的习惯, 所以...

banana_pi 2019-06-28 13:35 评论0 收藏0
Laravel 中创建 Zip 压缩文件并提供下载

摘要：文章转自更多文章如果您需要您的用户支持多文件下载的话，最好的办法是创建一个压缩包并提供下载。你看，你不需要任何的扩展包来实现这个压缩方式。 showImg(https://segmentfault.com/img/remote/1460000018734388?w=1500&h=800); 文章转自：https://learnku.com/laravel/t... 更多文章：https...

aboutU 2019-07-01 12:38 评论0 收藏0
PHP 项目中单独使用 Laravel Eloquent 查询语句来避免 SQL 注入

摘要：是一个记录当前应用所受威胁情况的项目。怎么做呢用参数化查询对数据格式化，并使查询语句与数据分离。使用参数化查询，可以确保程序远离注入风险。例子如下除此之外，还有一种安全的做法，就是在项目中使用对象关系映射或者是查询构造器。 showImg(https://segmentfault.com/img/remote/1460000018641613?w=1680&h=859); OWASP ...

dayday_up 2019-07-01 12:36 评论0 收藏0
Laravel 测试： PHPUnit 入门教程

摘要：介绍是最古老和最著名的单元测试包之一。它主要用于单元测试，这意味着可以用尽可能小的组件测试代码，但是它也非常灵活，可以用于很多不仅仅是单元测试。这时，的测试助手可以使这些测试像单元测试简单组件一样容易。新的测试代码如下注意到，在我们新建的 showImg(https://segmentfault.com/img/remote/1460000018355157?w=1440&h=585)...

张宪坤 2019-07-01 12:32 评论0 收藏0
Laravel深入学习5 - 应用架构

摘要：控制只是用来接收请求并请求逻辑处理类。事实上，业务逻辑无需感知网络，网络仅仅接入应用的传输机制，他不应超出应用中的路由和控制器的范畴。职责分离是编写健壮应用的关键。其他通常，类库应该以规范组织在我们的应用中。声明：本文并非博主原创，而是来自对《Laravel 4 From Apprentice to Artisan》阅读的翻译和理解，当然也不是原汁原味的翻译，能保证90%的原汁性，另...

lixiang 2019-06-27 16:32 评论0 收藏0