README

laravel-helper 是一个包含我在使用 Laravel 开发应用程序时发现有用的辅助函数的包。所有函数都通过 functions_exists() 包裹，以防冲突。

还可以看看

• https://laravel.net.cn/docs/10.x/helpers
• http://calebporzio.com/11-awesome-laravel-helper-functions (废弃？)
• https://packagist.org.cn/packages/illuminated/helper-functions
• https://packagist.org.cn/packages/laravel/helper-functions

这里应该包含什么想法？请提交拉取请求或发送电子邮件！

安装

$ composer require repat/laravel-helper

文档

⚠️ 大多数辅助函数现在在 repat/php-helper 中，这是此包的基础。您可以在 https://github.com/repat/php-helper 找到文档。

数据库

mysql_headers($table, $assoc = false)

返回一个包含 MySQL 头/列的数组或错误时的空数组。如果第二个参数设置为 true（默认为 false），则返回关联数组。

print_r(mysql_headers("test_table"));
// returns: Array( [0] => head1, [1] => head2 )

print_r(mysql_headers("test_table", $assoc = true));
// returns: Array( [head1] => head1, [head2] => head2)

table_headers($model)

返回数据库表头，类似于 mysql_headers()，但基于 Eloquent 模型的对象。

use App\Models\User;

$user = User::first();

print_r(table_headers($user));
// returns: Array( 1 => id, 2 => name, ...)

print_db_session($table = 'sessions')

打印当前用户的会话。

print_db_session();
// returns:
// Array
// (
//     [_token] => 7Au0aYkJVxQVA3xQBfdJwKNaWxUv0UVJKublCqMn
//     [locale] => en
//     ...
// )

get_free_slug($toSlug, $field, $fqcn, $id, $pk)

根据以下参数返回 Eloquent 模型的唯一 slug

• $toSlug: slug 的建议
• $field: 数据库字段名称，通常是 slug
• $fqcn: Eloquent 模型的完全限定名称
• $id: 要排除的 id（例如更新时自己的 id）
• $pk: 数据库表的 primary key，默认为 id

如果 $toSlug 已经被占用，将附加一个数字。

use App\Model\User;

$user = User::first();

$user->id;
// returns: 1
$user->slug;
// returns: foobar

get_free_slug('foobar', 'slug', User::class, 1, 'id');
// returns: foobar1

insert_bindings($query)

将值插入到 ? 中，从 ->toSql() 字符串。

insert_bindings(DB::table('users')->where('id', 1));
// returns: SELECT * FROM `users` WHERE `id` = '1'

对象

morph_map()

返回通过 Relation::morphMap() 在 AppServiceProvider 中设置的 morphMap。

morph_map();
// returns:Array
// (
//     [user] => App\Models\User
// )

morph_map_key($fqcn)

在 AppServiceProvider 的 morphMap 中对类进行反向查找，该 morphMap 通过 Relation::morphMap() 设置。

use App\Models\User;

morph_map_key(User::class);
// returns: 'user'

cache_get_or_add($key, $callable)

返回给定键的缓存或从可调用项添加返回值到缓存，然后返回它。

use App\Models\Post;

$posts = cache_get_or_add('posts', function() {
    return Post::orderBy('created_at', 'desc')->get();
});

dispatch_tinker($job)

从 tinker REPL 分发作业。

dispatch_tinker(new \App\Jobs\CleanupJob());
// returns: 1 (id of job)

网络

route_path($path)

获取 Laravel 路由文件夹的路径，类似于 app_path()，请参阅 辅助函数文档。它将附加 $path，但这不是必需的。

route_path();
// returns: /var/www/htdocs/laravel/routes

route_path('web.php');
// returns: /var/www/htdocs/laravel/routes/web.php

named_routes($path, $verb)

返回 routes 文件中所有命名路由的数组或错误时返回 null。可以传递定义在 HTTP_VERBS_LARAVEL 中的 HTTP 请求方法/动词（见下文）。

named_routes('/var/www/htdocs/laravel/routes/web.php');
// returns: [
// 'laravel.get'
// 'laravel.post'
// ]

named_routes('/var/www/htdocs/laravel/routes/web.php', 'get');
// returns: [
// 'laravel.get'
// ]

current_route_name()

如果当前路由有名称，则返回 null。

// in routes/web.php
// Route::name('dev.foo')->get('foo', 'Dev\TestController@foo');
// Route::get('bar', 'Dev\TestController@bar');

// in Dev/TestController@foo
current_route_name();
// returns: dev.foo

// in Dev/TestController@foo
current_route_name();
// returns: null

all_routes()

返回一个数组，其中包含所有路由，如下所示

all_routes();
// returns:
//      "name" => 'route.test', // could be null
//      "methods" => [
//          "GET",
//          "HEAD",
//      ],
//      "uri" => "test",
//      "action" => "\App\Http\Controllers\TestController@test",

route_exists($namedRoute)

检查给定的路由是否在任何 routes 文件中的命名路由。

route_exists('route.test');

// returns: true

route_exists('route.foobar')

// returns: false

可选包

此包建议的这些可选包对于这些函数的正常工作是必需的。

translated_attributes($fqcn)

使用astrotomic/laravel-translatable和反射来获取模型（Model）的translatedAttributes属性。

• $ composer require astrotomic/laravel-translatable

use App\Models\Product;

translated_attributes(Product::class);
// returns: ['title', 'description'];

HTML

extract_inline_img($text, $storagePath, $srcPath, $optimize)

从文本中提取内联图片，将其保存到硬盘上，并在具有src属性的文件名中。可以使用spatie/laravel-image-optimizer在上传后优化图片，但默认情况下是禁用的。

• $ composer require spatie/laravel-image-optimizer

extract_inline_img("<img src='data:image/jpeg;base64,...>", '/var/www/htdocs/laravel/storage/foobar', 'public/images', true);
// returns: <img src="public/images/fj3209fjew93.jpg">

常量

• HTTP_VERBS_LARAVEL：[所有、get、head、post、delete、options、put、patch]
• REGEX_IMG_BASE64_SRC：用于在HTML文本中查找base64编码的图片的正则表达式
• REGEX_IMG_BASE64_REPLACE：用于替换HTML文本中的base64编码图片的正则表达式
• 多重转换: 2

贡献者

• https://github.com/bertholf

许可证

• MIT，见LICENSE

版本

• 版本 0.6

联系方式

repat

• 主页：https://repat.de
• 电子邮件：repat@repat.de
• 推特：@repat123