添加自定义代码（PHP） | Fern Documentation

本页面介绍如何为您的 PHP SDK 添加自定义逻辑、方法和依赖项。

Before getting started, read about how Fern SDKs use custom code and learn about the .fernignore file.

添加自定义逻辑

开始添加自定义代码：

创建新文件并添加您的自定义逻辑

src/Helper.php

1 <?php
2 
3 namespace YourNamespace;
4 
5 class Helper
6 {
7     public static function myHelper(): void
8     {
9         echo "Hello World!";
10     }
11 }

将您的文件添加到 `.fernignore`

.fernignore

1 # Specify files that shouldn't be modified by Fern
2 
3 src/Helper.php

使用辅助方法

Now your users can consume the helper function by importing it from the SDK.

1 <?php
2 
3 use YourNamespace\Helper;
4 
5 Helper::myHelper();

添加自定义 SDK 方法

Fern also allows you to add custom methods to the SDK itself (e.g. client.my_method() ) by inheriting the Fern generated client and then extending it.

更新 `generators.yml` 配置

将您的 Fern 生成的客户端命名为类似 BaseClient 的名称，以反映此客户端将被扩展。

generators.yml

1 - name: fernapi/fern-php-sdk
2   version: 2.8.1
3   config:
4     clientName: BaseClient

导入并扩展生成的客户端

首先，导入 Fern 生成的基础客户端并扩展它。然后，添加您想要的任何方法。

src/MyClient.php

1 <?php
2 
3 namespace YourNamespace;
4 
5 class MyClient extends BaseClient
6 {
7     public function myHelper(): void
8     {
9         echo "Hello World!";
10     }
11 }

更新 `.fernignore`

将 MyClient.php 添加到 .fernignore。

.fernignore

1 + src/MyClient.php

使用方法

您的用户将构造扩展的客户端，而不是构造生成的客户端。

1 <?php
2 
3 use YourNamespace\MyClient;
4 
5 $client = new MyClient();