Skip to content

docs: add address resolver how-to guide (PHP, C#)#232

Draft
Aryex wants to merge 2 commits into
mainfrom
alexl/agent/php-address-resolver-docs
Draft

docs: add address resolver how-to guide (PHP, C#)#232
Aryex wants to merge 2 commits into
mainfrom
alexl/agent/php-address-resolver-docs

Conversation

@Aryex

@Aryex Aryex commented Jun 5, 2026

Copy link
Copy Markdown
Collaborator

Summary

Add documentation for the address resolver feature across PHP and C# clients.

⚠️ Attention: This PR was generated automatically. Verify that all relevant pages have been updated.

Source Commits

  • 8f00aae — feat: add address resolver support for standalone and cluster clients.
  • 7a822d4 — Support custom socket address resolution (#392)

Changes

  • Added new how-to page: how-to/connections/address-resolver.mdx
  • Covers basic usage, fallback behavior, and cluster client usage
  • PHP examples for ValkeyGlide and ValkeyGlideCluster
  • C# examples using StandaloneClientConfigurationBuilder / ClusterClientConfigurationBuilder with WithAddressResolver()
  • Language-specific notes (PHP: MSHUTDOWN/RSHUTDOWN cleanup; C#: thread-safety, 1024-byte hostname limit, internal GC pin)

Context

Php #196 adds a custom address resolver callback to both standalone and cluster PHP clients. C# #392 ports the same feature to the C# client using AddressResolverDelegate and the WithAddressResolver() builder method.

The resolver intercepts host/port resolution at connection time, enabling DNS overrides, service mesh scenarios, and testing with fake addresses. If the resolver throws or returns invalid data, the client gracefully falls back to the original address.

cc @affonsov


This PR was generated by the automated documentation pipeline.

Signed-off-by: kiro-agent <kiro-agent@users.noreply.github.com>
Signed-off-by: kiro-agent <kiro-agent@users.noreply.github.com>
@Aryex Aryex changed the title docs: add PHP address resolver how-to guide docs: add address resolver how-to guide (PHP, C#) Jun 5, 2026
@Aryex

Aryex commented Jun 5, 2026

Copy link
Copy Markdown
Collaborator Author

📝 Updated PR description with 7a822d4 — Support custom socket address resolution (#392)

Added C# code examples to the address resolver how-to page covering basic usage, fallback behavior, and cluster client configuration.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants