From 9fd91f41b69f1b94b2e95889da8db7e5f5074a49 Mon Sep 17 00:00:00 2001
From: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Date: Tue, 4 Aug 2026 17:04:58 +0000
Subject: [PATCH] docs(sdks): document PHP encode-path-params config option
Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
---
fern/products/sdks/generators/php/configuration.mdx | 4 ++++
1 file changed, 4 insertions(+)
diff --git a/fern/products/sdks/generators/php/configuration.mdx b/fern/products/sdks/generators/php/configuration.mdx
index b330555d07..0808a1a05c 100644
--- a/fern/products/sdks/generators/php/configuration.mdx
+++ b/fern/products/sdks/generators/php/configuration.mdx
@@ -34,6 +34,10 @@ Allows customization of the generated `composer.json` file contents. You can spe
When enabled, generates [mock server (wire) tests](/sdks/deep-dives/testing#mock-server-tests) to verify that the SDK sends and receives HTTP requests as expected.
+
+Percent-encodes path parameter values as the generated SDK substitutes them into the request path, so a value containing `/` or `..` can't change which endpoint the request resolves to. Values that intentionally contain slashes, such as file-path-like IDs, are sent as `%2F`.
+
+
When enabled, path parameters are included as properties in the request class instead of being passed as separate method parameters. This creates a more unified request structure where all parameters are grouped together in the request object.