PHPackages                             beyondcode/claude-hooks-sdk - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. beyondcode/claude-hooks-sdk

ActiveLibrary[Utility & Helpers](/categories/utility)

beyondcode/claude-hooks-sdk
===========================

A PHP SDK for building Claude Code hooks.

0.1.0(10mo ago)63622↓50%8[2 issues](https://github.com/beyondcode/claude-hooks-sdk/issues)[5 PRs](https://github.com/beyondcode/claude-hooks-sdk/pulls)MITPHPPHP ^8.3CI passing

Since Jul 3Pushed 2mo ago1 watchersCompare

[ Source](https://github.com/beyondcode/claude-hooks-sdk)[ Packagist](https://packagist.org/packages/beyondcode/claude-hooks-sdk)[ Docs](https://github.com/beyondcode/claude-hooks-sdk)[ GitHub Sponsors](https://github.com/beyondcode)[ RSS](/packages/beyondcode-claude-hooks-sdk/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)Dependencies (2)Versions (6)Used By (0)

Claude Hooks SDK
================

[](#claude-hooks-sdk)

[![Latest Version on Packagist](https://camo.githubusercontent.com/a1a2588ec21d9d8f075940001b258fff70d5db63322ca61a5df258092c86dd7a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6265796f6e64636f64652f636c617564652d686f6f6b732d73646b2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/beyondcode/claude-hooks-sdk)[![Tests](https://camo.githubusercontent.com/7543492bf7339938d70af3e132179072b722e6e17cbaab197e3725e6c61344bf/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6265796f6e64636f64652f636c617564652d686f6f6b732d73646b2f72756e2d74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/beyondcode/claude-hooks-sdk/actions/workflows/run-tests.yml)[![Total Downloads](https://camo.githubusercontent.com/815852868905a0471c9f57d563c558ee5da886b059dc4671992f6b94a1169be2/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6265796f6e64636f64652f636c617564652d686f6f6b732d73646b2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/beyondcode/claude-hooks-sdk)

A Laravel-inspired PHP SDK for building Claude Code hook responses with a clean, fluent API. This SDK makes it easy to create structured JSON responses for Claude Code hooks using an expressive, chainable interface.

Claude Code hooks are user-defined shell commands that execute at specific points in Claude Code's lifecycle, providing deterministic control over its behavior. For more details, see the [Claude Code Hooks documentation](https://docs.anthropic.com/en/docs/claude-code/hooks).

Installation
------------

[](#installation)

You can install the package via composer:

```
composer require beyondcode/claude-hooks-sdk
```

Usage
-----

[](#usage)

### Creating a Claude Hook

[](#creating-a-claude-hook)

Here's how to create a PHP script that Claude Code can use as a hook:

#### Step 1: Create your PHP hook script

[](#step-1-create-your-php-hook-script)

Create a new PHP file (e.g., `validate-code.php`) using the SDK:

```