Community SDK Submission: PHP — a2a-php-sdk (A2A v1.0.0)

Open Beginner friendly
#2,235 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
78/100
Issue type
Documentation
Clarity
Mostly clear
Activity status
Active
Tech stack
php
Domain
documentation

Research direction

Start with docs/community.md and review the format of existing Community SDK entries. Verify the linked a2a-php-sdk repository and Packagist package, then add the SDK in the matching format with its relevant links; done means the entry is accurate and the documentation change is ready for review.

Written by the indexing model from the issue text.

Description

Submitting a PHP SDK for the Community SDKs section of docs/community.md, following the
"Want to add your SDK?" note.

Repository: https://github.com/vbcherepanov/a2a-php-sdk
Package: https://packagist.org/packages/vbcherepanov/a2a-php-sdk (v1.0.0)
Optional Symfony integration: https://github.com/vbcherepanov/a2a-symfony-bundle
(https://packagist.org/packages/vbcherepanov/a2a-symfony-bundle)

What it is: a client and server SDK for A2A spec v1.0.0, PHP 8.4+. Protobuf classes are
generated from the official v1.0.0 a2a.proto; all 11 operations are implemented over
JSON-RPC, HTTP+JSON/REST and gRPC, with SSE and gRPC server streaming.

Against the listed requirements:

  • Spec compliance: the repository runs the official a2a-tck 1.0.0 across all three
    transports (make tck). On the pinned TCK commit: 244 passed, 3 failed, 18 skipped. The
    three failures are CORE-SEND-003, a TCK defect tracked in a2aproject/a2a-tck#202 with
    approved PR a2aproject/a2a-tck#203; at that PR's head the run is 247 passed, 18 skipped. Reports are in
    docs/tck-revisions/. This is not a claim of full certification.
  • Published package: Packagist.
  • Documentation: README and docs/.
  • Tests with CI: GitHub Actions.
  • License: Apache-2.0.
  • Maintenance: actively maintained; I plan to follow the v1.0.1 TCK update (a2a-tck#240).

As far as I can tell, the existing PHP implementations on Packagist target v0.3.0.
If this looks acceptable, I'm happy to open a PR adding the entry.

Dominant language
Shell
Stars
25.9k
Forks
2.6k
Avg merge
1d 4h
Merged PRs (30d)
11

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from a2aproject/A2A

All issues in a2aproject/A2A

Similar issues

More Shell/Bash issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.