Weave Code
Kiota Serialization Form Laravel Package
microsoft/kiota-serialization-form
PHP serialization library for Kiota-generated API clients that handles application/x-www-form-urlencoded request and response payloads. Install via Composer with microsoft/kiota-serialization-form to add form-encoded serialization support to your generated SDK.
Kiota form serialization implementation for PHP
Frequently asked questions about Kiota Serialization Form
- What is microsoft/kiota-serialization-form used for in Laravel?
- microsoft/kiota-serialization-form is a PHP serialization library for Kiota-generated API clients. It handles application/x-www-form-urlencoded request and response payloads, so Laravel apps using Kiota models can serialize form data consistently instead of manually building query strings.
- How do I install microsoft/kiota-serialization-form in a Laravel app?
- Install it with Composer by running composer require microsoft/kiota-serialization-form. You typically add it alongside the Kiota core and HTTP packages required by your generated client. If your Laravel app already uses Kiota-generated SDKs, no Laravel-specific package is needed.
- Does microsoft/kiota-serialization-form work with Laravel's HTTP client?
- It does not provide a native Laravel HTTP client middleware. You need to bridge Kiota RequestInformation or serialized payloads to Laravel's Http facade or Guzzle with custom wiring. For Kiota-generated clients, the serializer is normally used through Kiota's request pipeline rather than directly in Laravel HTTP calls.
- What PHP version does microsoft/kiota-serialization-form require?
- Version 2.x requires PHP 8.2 or newer, which is a breaking change from earlier releases. If your Laravel app runs on PHP 8.1 or older, you would need to use v1.x, such as the last PHP 7.4-compatible release, but those older PHP versions are end-of-life and carry security risk.
- Can I use microsoft/kiota-serialization-form without Kiota-generated clients?
- It can technically be instantiated on its own, but its main value is serializing and deserializing Kiota models. If you are not using Kiota-generated clients, Laravel's HTTP client and standard form encoding are usually simpler. Evaluate whether adopting Kiota is justified before adding this package only for form serialization.
- How does it compare to http_build_query or Laravel FormRequest for form encoding?
- Manual http_build_query is simpler but less type-safe and does not integrate with Kiota models. Laravel FormRequest is useful for request validation but is not a model serialization layer. This package is the better fit when your API contracts are Kiota-generated and you need consistent form encoding.
- How do I register or inject the Kiota form serializer in Laravel?
- You can register it in a Laravel service provider by binding the Kiota form serializer class and resolving it through dependency injection. For example, bind a factory that returns a new serializer instance, then inject it into the service that builds API requests. If you use Kiota's request adapter, configure the serializer in that adapter's pipeline instead of calling it directly.
- Is microsoft/kiota-serialization-form safe for production use?
- It is maintained by Microsoft and is suitable for production when used with compatible Kiota packages and supported PHP versions. Pin your Composer versions to avoid mismatches across the Kiota PHP ecosystem, and test complex objects, nested arrays, nulls, and booleans. The package is focused on form serialization, so pair it with Laravel validation and error handling as needed.
- What are alternatives to microsoft/kiota-serialization-form for form serialization in Laravel?
- Alternatives include manual http_build_query, Symfony's FormEncoder, or Laravel's FormRequest for HTTP request validation. Manual encoding is less type-safe, Symfony's encoder can be heavier than needed, and FormRequest does not serialize Kiota models. Use microsoft/kiota-serialization-form when Kiota-generated models and form payloads are central to your integration.
- How is microsoft/kiota-serialization-form maintained and which version should I use for older Laravel apps?
- Microsoft maintains Kiota, but this repository is release-focused and issues or pull requests go to the kiota-php monorepo. For current Laravel apps on PHP 8.2 or newer, use the latest 2.x release. For legacy apps on PHP 8.1 or older, v1.x may be the only option, but upgrading PHP is strongly preferred.
Weaver
How can I help you explore Laravel packages today?