Bring the PHP client to parity with serpapi-ruby (#3) * Report library name and version in source parameter The client sent `source=php`, which made it impossible to tell PHP client versions apart in SerpApi usage statistics. Report `serpapi-php:` instead, matching the `serpapi-ruby:` convention. Query assembly moves into buildQuery(), and request() becomes a protected seam so tests can observe outgoing requests through a recording double instead of reflecting into private methods or hitting the network. Co-authored-by: Victor Benarbia * Support default search parameters in the constructor The constructor only accepted api_key, engine and timeout, so parameters like location, hl, gl or no_cache had to be repeated on every search call. The Ruby client takes a hash where any unrecognized key becomes a default search parameter. Add a fourth positional argument for default parameters, and accept a configuration array as the first argument for parity with the Ruby client. Configuration keys are honored in either array, rather than silently dropped. Per-call parameters take precedence, a null value drops a default for one call, and a per-call `timeout` applies to that request instead of being sent to the API. The effective values are exposed via getParams() and getTimeout(). The existing positional signature is unchanged. Co-authored-by: Victor Benarbia * Mask the API key in client debug output var_dump() on a client printed the API key in clear text, so a key could end up in logs or a bug report. The Ruby client masks it in inspect. Add __debugInfo() to mask the key for var_dump(), print_r() and debuggers, plus an inspect() method for parity. Keys of 8 characters or fewer are replaced entirely rather than partially revealed. var_export() and (array) casts read properties directly and cannot be hooked; this is called out in the docblock. Co-authored-by: Victor Benarbia * Reuse the connection across requests Every request created and destroyed its own cURL handle, paying for DNS, TCP and TLS setup each time. The Ruby client keeps a persistent socket and reports roughly twice the throughput because of it. Keep one cURL handle per client and reuse it, so curl holds the connection open between requests. Measured against the locations endpoint, five warmed-up requests drop from ~300ms to ~100ms. Persistent mode is on by default, matching the Ruby client, and can be turned off with `['persistent' => false]`. close() releases the connection and the client reconnects on the next request; the destructor closes it too, so existing code needs no change. Holding a handle brings lifecycle concerns that are handled explicitly: - a clone opens its own connection instead of sharing the original's, which on PHP 7 it would otherwise close when destroyed - the handle is left out of serialization, since serializing a CurlHandle throws on PHP 8 and would break clients stored on queued jobs - a stale handle (closed, or deserialized on PHP 7.2/7.3) is replaced - a per-call `persistent` is rejected rather than silently ignored Co-authored-by: Victor Benarbia * Add searchArray() returning results as an associative array search() keeps returning stdClass. Error and search id extraction now reads both decoded shapes. Co-authored-by: Victor Benarbia * Add example tests for the engines covered by serpapi-ruby Ports the PR's engine examples to the master test style and adds google_ai_mode. Compared to the original PR: - amazon searches with `k`, its query parameter, instead of `q` - google_videos asserts `video_results`, which the engine returns - google_images drops the redundant `tbm=isch` - google_flights matches the Ruby spec (LAX to AUS) and accepts either `best_flights` or `other_flights` - google_immersive_product and google_product take a page_token and a product_id from a live Google Shopping search instead of hardcoding values that go stale, and skip when none is returned - google_ai_overview bypasses the cache when fetching its page_token, which expires a minute after the search Co-authored-by: Victor Benarbia * Add demo scripts and a make demo target demo.php runs a basic search, demo_suggest.php reuses default search parameters, demo_async.php submits a batch with async and collects it through the Search Archive API, and demo_persistent.php benchmarks connection reuse. Compared to the original PR: - the async demo stops polling on Success, fails fast on an archived error, and passes `async` per call so it is not also sent with every Search Archive request - the benchmark warms up both clients before timing them - `demo` is declared .PHONY; otherwise make sees the demo/ directory and reports the target as up to date without running anything - demo/ is linted with phpcs Co-authored-by: Victor Benarbia * Add PHPStan static analysis Analyses src and demo at level 6, from `composer analyse` or `make analyse`. CI runs it once, in the lint job, rather than across the PHP matrix. searchArchive() now declares that the json format returns an object, so callers need not narrow object|string themselves. Co-authored-by: Victor Benarbia * Document the new client features and engines Covers searchArray(), per-call timeouts, default search parameters, persistent connections, API key masking, the demo scripts and static analysis, and adds a section for each engine with a new example. The snippet helper now matches assertions split over several lines, as master formats them. Google Autocomplete, Google Shopping and Google Events previously fell back to printing organic_results. Co-authored-by: Victor Benarbia * Fix engine examples that fail against the live API Running the examples with an API key showed four failures and one skip, all inherited from the serpapi-ruby specs: - google_light_search is not a SerpApi engine ("Unsupported `google_light_search` search engine"); remove the example - google_finance no longer returns `markets` for a ticker; assert `summary`, which it does return - google_reverse_image found nothing for the old sample image; use the one from the current API docs, which returns `image_results` - google_product found nothing for any product_id taken from Google Shopping; take the shopping result's page_token instead, the other documented way to identify a product - google_ai_overview always skipped: Google now shows the overview inline for "what is coffee". Use the query from the API docs, which still returns a page_token --------- Co-authored-by: Josef Strzibny

Sunbelt Computer Software

PL/B Language Development and Support