README

本项目旨在使使用 Laravel 框架更加有序和可扩展。

目录

• Mongez
• 目录
• 要求
• 安装
• 配置
  • 可翻译
  • 变更日志
• 文档

要求

• Laravel >=11

为了与 Laravel 10 兼容，请使用本包的 3.0 版本。

为了与旧版本的 Laravel 兼容，请使用本包的 2.x 版本。

安装

在您的 CLI 中运行以下命令。

composer require hassanzohdy/mongez

配置

完成后，运行以下命令以创建 config/mongez.php 文件。

php artisan vendor:publish --provider="HZ\Illuminate\Mongez\Providers\MongezServiceProvider"

可翻译

<?php
use HZ\Illuminate\Mongez\Translation\Traits\Translatable;

class MyClass
{
  use Translatable;

  public function index()
  {
    $this->transUsers('users.name'); // will translate from `Users` module and `users` file and the keyword is `name
    $this->transUsers('usersGroups.permissions'); // will translate from `Users` module and `usersGroups` file and the keyword is `permissions
  }
}

变更日志

• 3.1.0 (2024年9月29日)
  • 更新代码库以支持 Laravel 11+
  • 移除 Carbon 的 setWeekStartsAt 和 setWeekEndsAt，因为它们已从 carbon 中移除。
• 3.0.1 (2024年9月29日)
  • 更新代码库以支持 Laravel 10，并新增 MongoDB Eloquent 集成。
• 2.24.2 (2023年12月24日)
  • 修复了请求 SQL 选项被当前类 SQL 选项覆盖的问题。
• 2.24.1 (2022年11月24日)
  • 修复了 date_response 中的日期为空数组的问题。
• 2.24.0 (2022年11月24日)
  • 增强了资源管理器错误，以显示资源类名。
• 2.23.5 (2022年10月23日)
  • 现在生成的模型将具有 casts 属性，而不是 dates 用于日期转换。
• 2.23.4 (2022年10月22日)
  • 修复了在 functions.php 文件中定义 UTCDateTime 类命名空间的问题。
• 2.23.3 (2022年10月22日)
  • 修复了可收集项以返回正确的数组语法而不是对象。
• 2.22.2 (2022年8月28日)
  • 修复了在列表中 ARRAYABLE_DATA 被编码为 JSON 的问题。
• 2.22.1 (2022年8月28日)
  • RepositoryManager.wrapMany 将在没有传递集合到资源的情况下返回空数组，如果给定的数组|集合为空。
• 2.22.0 (2022年8月28日)
  • config/mongez.php 配置
  • 将 misc 键更改为 date。
  • 在 date 键下将 CarbonImmutable 更改为 immutable。
  • 添加了 week_starts_at 并默认为 Saturday。
  • 添加了 week_ends_at 并默认为 Friday。
• 2.21.0 (2022年8月27日)
  • 在资源管理器中添加了 getPaginationInfo。
  • getPaginateInfo 现已弃用，并将被移除在 V3.0 中。
  • 添加了 first 方法，用于返回第一个匹配的元素，它接受与 listModels 相同的数组选项，并返回一个模型。
• 2.20.0 (2022年8月27日)
  • 在资源中添加了 saveActionType 属性，它可以在 setData 中使用，其值将取决于当前操作，static::CREATE_ACTION | static::UPDATE_ACTION | static::PATCH_ACTION。
• 2.18.0 (2022年8月17日)
  • 添加了 date_response，用于将给定日期格式化为 timestamp、humanTime、text 和 format 输出。
  • 添加了 localized_date，用于将给定日期转换为基于区域代码的格式化日期。
  • 在资源管理器中使用 date_response 收集日期。
• 2.17.0 (2022年8月15日)
  • 添加了聚合工具。
• 2.16.0 (2022年8月14日)
  • 在 FILTER_BY 资源常量中添加了 date 和 date:between 过滤器。
• 2.15.0（2022年8月12日）
  • 添加了 carbonImmutable 功能，将 now 函数转换为不可变的 carbon 实例。
• 2.14.0（2022年8月10日）
  • 向资源管理器添加了 LOCATION_DATA 常量，以返回正确的地理位置数据。
• 2.12.0（2022年7月26日）
  • 向资源管理器添加了 LOCALIZED_COLLECTABLE_DATA 常量，用于本地化数组列表中的数据。
• 2.11.0（2022年7月23日）
  • 现在，在资源管理器中，如果将 WHEN_AVAILABLE 设置为 true，它将去除模型中的任何缺失值，因此资源将仅返回现有数据，而不会为任何缺失数据提供默认值。
• 2.1.21（2022年2月28日）
  • 修复了多重特性方法别名问题。
• 2.1.20（2022年2月28日）
  • 修复了缺少分号的问题。
• 2.1.19（2022年2月28日）
  • 在创建子模块时，修复了在仓库中 Model、Resource 和 Filter 的错误，以接收子模块名称而不是父模块名称。
• 2.1.17（2022年2月28日）
  • 添加了 Translatable 特性。
• 2.1.14（2022年2月28日）
  • 修复了生成的 database 目录，现在为 Database。

文档

请参阅wiki页面中的完整文档。