Laravel 数据库哈希包安装与使用指南

Laravel 数据库哈希包安装与使用指南

laravel-database-hashingA package for automatically hashing Eloquent attributes in Laravel 5.5+项目地址:https://gitcode.com/gh_mirrors/la/laravel-database-hashing

本指南将引导您了解并使用 JackNoordhuis/laravel-database-hashing 这一开源项目，专为 Laravel 5.5 及以上版本设计，用于自动加密 Eloquent 模型属性到数据库中。我们将依次探索其目录结构、启动文件以及配置文件的相关知识。

1. 目录结构及介绍

该开源项目的文件结构遵循了清晰且标准化的原则，以确保易于理解和维护：

.
├── config            # 配置文件所在目录，存放项目的特定配置。
│   └── database_hashing.php
├── src               # 核心源代码，包含了处理数据加密的核心逻辑。
│   ├── DatabaseHasher.php
│   └── ...
├── tests             # 单元测试文件，用于保障代码质量。
│   ├── Feature
│   └── Unit
├── .gitignore        # 忽略的文件列表
├── composer.json     # 依赖管理文件，定义了项目所需的所有依赖及其版本。
├── composer.lock     # 锁定文件，记录具体安装的依赖版本。
├── phpunit.xml       # PHP单元测试的配置文件。
├── README.md         # 项目的主要说明文件，包括快速入门和基本用法。
└── LICENSE           # 许可证文件，声明该项目遵循 LGPL-3.0 许可协议。

• config: 存储特定于此扩展的配置，允许用户自定义哈希行为。
• src: 包含主要功能实现，如模型属性的自动加密逻辑。
• tests: 确保代码可靠性的测试案例存放处。

2. 项目的启动文件介绍

这个特定的项目没有传统意义上的“启动文件”，它的集成主要是通过 Laravel 的服务提供者（Service Provider）机制完成的。在安装完成后，Laravel 的自动加载机制会处理所有必要文件的载入，无需手动引入任何启动文件。关键在于注册服务提供商，这通常通过修改 app/config/app.php 文件中的 providers 数组来完成，加入项目提供的服务提供者类。

3. 项目的配置文件介绍

在成功安装插件之后，你需要关注的是 config/database_hashing.php 文件。这个配置文件是自动生成或由用户手动创建，它提供了定制化选项，例如可以指定哪些 Eloquent 模型属性应当被自动加密，以及使用的哈希算法等。配置项可能包括：

• model_mapping: 定义模型与需要哈希的字段映射。
• hashing_algorithm: 指定默认的哈希算法，如 bcrypt 或其他支持的加密方式。
• options: 可能包含额外的算法选项，具体取决于所选的哈希方法。

为了启用并配置该插件，您需要按照以下步骤操作：

1. 在 Laravel 项目中运行命令安装依赖：composer require jacknoordhuis/laravel-database-hashing.
2. 发布配置文件：php artisan vendor:publish --provider="JackNoordhuis\LaravelDatabaseHashing\Providers\DatabaseHashServiceProvider" --tag=config。
3. 修改 database_hashing.php 根据您的应用需求进行相应配置。
4. 最后，确保你的模型适应这一变化，可能会涉及到更新模型或利用包提供的特性注解。

通过这种方式，您可以轻松集成自动加密特性，增强应用程序的数据安全性。

laravel-database-hashingA package for automatically hashing Eloquent attributes in Laravel 5.5+项目地址:https://gitcode.com/gh_mirrors/la/laravel-database-hashing