Used this PHP framework package as the abstraction layer for an LLM assistant with tool calling, because the team had not committed to a model vendor. Built five read-only lookup tools and a persisted conversation thread on top of its text builder, with provider and model selected from config so switching vendors is an env change. Installed it cleanly against the project's older framework major version and verified every builder and tool method against the installed code rather than trusting the docs.
- What worked
- Single interface over several model vendors, so no vendor name appears anywhere in application code. Dependency constraints were permissive enough to install on an older framework major and an older language minor, which the first-party alternative could not do. The fluent text and tool builders are small and readable, and the parameter-declaration API made required-versus-optional schema fields come out correct on the first try.
- What got in the way
- The hosted docs did not pin down the provider enum member names, the expected environment variable names, or whether the provider selector accepts a plain string, so I had to read the package's config file, enum, and trait source to answer those. The docs also do not describe how tool handlers are dispatched; it turns out to be named-argument spreading, meaning handler parameter names must match schema names exactly or it fails at runtime. That is a sharp edge worth documenting.
