English
资源说明：**Laravel 开发与 FileMaker API 的整合**
`Laravel` 是一个流行的开源 PHP 框架，以其优雅的语法和强大的功能深受开发者喜爱。它提供了丰富的工具和库，简化了Web应用的开发过程。而 `fm-laravel` 是一个专门为 Laravel 设计的包装器，目的是方便地集成 FileMaker API，使开发者能够更轻松地与 FileMaker 数据库进行交互。
**FileMaker API 简介**
FileMaker 是一个关系型数据库管理系统，它提供了直观的界面和强大的数据管理功能，适用于小型到中型企业。FileMaker 提供了一个 API（应用程序接口），允许开发者通过编程方式与 FileMaker 数据库进行通信，执行诸如创建、读取、更新和删除（CRUD）等操作。
**`fm-laravel` 包的作用**
`fm-laravel` 包是为 Laravel 应用程序设计的一个便捷工具，它封装了 FileMaker API 的调用，使得在 Laravel 中处理 FileMaker 数据变得更加简单。这个包提供了 Laravel 风格的助手方法和模型，使得与 FileMaker 数据库的交互更加符合 Laravel 的编程习惯。
**使用 `fm-laravel` 进行开发**
1. **安装**：你可以通过 Composer 在 Laravel 项目中安装 `fm-laravel` 包。在终端中运行以下命令：
```bash
composer require fm/fm-laravel
```
2. **配置**：接着，需要配置 `fm-laravel`。在 `config/app.php` 文件中注册服务提供者，并在 `config` 目录下创建 `filemaker.php` 配置文件，设置 FileMaker API 的连接参数，如服务器地址、数据库名、用户名和密码。
3. **认证与连接**：`fm-laravel` 使用 Laravel 的服务容器来管理 FileMaker 客户端实例，提供了一种方便的方式进行认证和建立连接。
4. **模型定义**：你可以定义自己的 Eloquent 模型来映射 FileMaker 的表。这些模型将扩展 `FM\Eloquent\Model` 类，提供对 FileMaker 记录的 CRUD 操作。
5. **查询与操作**：通过模型，你可以像使用 Laravel Eloquent ORM 一样进行查询和数据操作。例如，创建新记录、读取记录、更新记录和删除记录。
6. **事件与回调**：`fm-laravel` 还支持 Laravel 的事件系统，可以在数据操作前后触发自定义事件，实现业务逻辑的扩展。
7. **错误处理**：包装器会处理 FileMaker API 的错误，并转换为 Laravel 可以处理的异常，便于你在应用中统一处理错误。
通过 `fm-laravel`，开发者可以充分利用 Laravel 的强大力量和优雅的代码风格，同时无缝对接 FileMaker 数据库。这大大降低了开发复杂性，提高了工作效率，使得在 Laravel 应用中集成 FileMaker 成为一种愉快的体验。无论你是构建 CRM 系统、进销存管理还是其他基于 FileMaker 的 Web 应用，`fm-laravel` 都是一个值得信赖的工具。
本源码包内暂不包含可直接显示的源代码文件，请下载源码包。
