Changelog

1.16.5

(fix): Fix duplicate array types in undiscriminated union properties. Previously, nested unions containing different array types (e.g., array<string, mixed> and array<Recipient>) would generate duplicate array annotations in PHP union types (array|array|null). The fix implements recursive union flattening with proper deduplication during type generation.

1.16.4

(feat): Add documentation for using a custom client in the README. This makes it easier for our customers to visualize how they can override the default client.

1.16.3

(feat): Add documentation for pagination in the README, this uses the AST to build some human readable example of how to use the pagination on the client results.

1.16.2

(feat): Add documentation for retries and timeout parameters in the README, including examples of how to configure maxRetries and timeout options at the request level

1.16.1

(feat): Add exception handling documentation to README with examples of catching and handling API exceptions

1.16.0

(feat): Introduce initial version of README generation for the PHP SDK with Installation, Usage, and Contributing sections.

1.15.1

(internal): Update the IR to v58.

0.15.0

(feat): Support custom package path

0.14.2

(fix): This updates the PHP generator to better support undiscriminated unions that define one or more optional types. With this, the generator unwraps each of the optional types, and includes a |null variant (e.g. array<string, mixed>|Metadata|null).

0.14.1

(internal): Upgrade to IRv57.

0.14.0

(feat): Support literal types

0.13.7

(fix): Make constructor private for union types and remove static unknown constructor

0.13.6

(fix): Fix an issue where the value field of the deserialized discriminated union was null.

0.13.5

(fix): Change discriminated union method name from ->getvalue() to ->getValue().

0.13.4

(fix): Flatten test directory structure from tests/package-name/** to tests/** so it matches the psr-4 structure defined in composer.json. Without this change, you cannot reference classes within the tests directory from your tests, for example, a Helpers class for common test utilities.

0.13.3

(fix): Fix issue where an empty request would be JSON serialized as an empty array instead of an empty object.

0.13.2

(fix): Fix a bug where literal global headers could not be overridden in the root client constructor.

0.13.1

(fix): Render union references as their type references rather than mixed.

0.13.0

(feat): Add support for configuring a request timeout.

(fix): Fix a bug where the private pagination method helpers collided with magic methods (e.g. __get).

0.12.0

(feat): Add support for discriminated unions.

0.11.0

(feat): The SDK now supports a bodyProperties and queryParameters request option, which can be used to add arbitrary properties to the request. This is useful for interacting with alpha or undocumented functionality.

1
  new ListUsersRequest([
2
    ...
3
  ]),
4
  [
5
    'queryParameters' => [
6
      'limit' => 100,
7
    ],
8
  ]
9
); ```

0.10.0

(feat): You can now modify the generated composer.json file by adding a composerJson property to your generator configuration. Here’s an example of the generators.yml file with the composerJson property:

1
  php-sdk:
2
    generators:
3
      - name: fernapi/fern-php-sdk
4
        ...
5
        config:
6
          composerJson:
7
            description: This is my PHP library
8
            keywords:
9
            - myCustomTag
10
            license:
11
            - "LGPL-2.1-only"
12
            - "GPL-3.0-or-later"
13
            scripts:
14
              hello: echo hello

Which will result in the following composer.json file:

1
  // ...,
2
  "description": "This is my PHP library",
3
  "keywords": [
4
    "myCustomTag",
5
    // ...,
6
  ],
7
  "license": [
8
    "LGPL-2.1-only",
9
    "GPL-3.0-or-later"
10
  ],
11
  // ...,
12
  "scripts": {
13
    // ...,
14
    "hello": "echo hello"
15
  }
16
} ```
17
18
## 0.9.0
19
**`(feat):`** Add the ability to access alpha or undocumented response properties from every class. Users can access the additional properties like so:
20
```php $response = $client->users->get(...); $additionalProperties = $response->getAdditionalProperties(); ```
21
22
## 0.8.0
23
**`(feat):`** Add automatic pagination support for endpoints that return a paginated response.
24
Here's an example of how users can use paginated endpoints:
25
```php $items = $client->list($request); foreach($items as $item){
26
    echo $item;
27
} $pages = $items->getPages(); foreach($pages as $page){
28
    foreach($page as $item){
29
        echo $item;
30
    }
31
} ```