Add phar build

.craft.yml

@@ -0,0 +1,9 @@
+minVersion: 0.23.1
+changelogPolicy: simple
+artifactProvider:
+  name: none
+targets:
+  - name: github
+  - name: registry
+    sdks:
+      composer:sentry/sentry-agent:

.gitattributes

@@ -12,6 +12,8 @@
 # Exclude non-essential files from dist
 /tests export-ignore
 /stubs export-ignore
+/scripts export-ignore
+/examples export-ignore
 /.appveyor.yml export-ignore
 /.craft.yml export-ignore
 /.editorconfig export-ignore
@@ -28,3 +30,6 @@
 /codecov.yml export-ignore
 /.github export-ignore
 /phpbench.json export-ignore
+
+# Exclude the agent package code, only the phar is needed for distribution
+/agent export-ignore

.github/workflows/cs.yaml

@@ -15,12 +15,12 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
 
       - name: Setup PHP
         uses: shivammathur/setup-php@9e72090525849c5e82e596468b86eb55e9cc5401 # pin@2.32.0
         with:
-          php-version: '8.3'
+          php-version: '8.4'
 
       - name: Install dependencies
         run: composer update --no-progress --no-interaction --prefer-dist

.github/workflows/phar.yaml

@@ -0,0 +1,65 @@
+name: Build PHAR
+
+on:
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  build-agent:
+    name: Build Agent
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - name: Internal github app token
+        uses: actions/create-github-app-token@a8d616148505b5069dccd32f177bb87d7f39123b # v2.1.1
+        id: app-token
+        with:
+          app-id: ${{ vars.SENTRY_RELEASE_BOT_CLIENT_ID }}
+          private-key: ${{ secrets.SENTRY_RELEASE_BOT_PRIVATE_KEY }}
+
+      - name: Checkout
+        uses: actions/checkout@v5
+        with:
+          token: ${{ steps.app-token.outputs.token }}
+          fetch-depth: 0
+          ref: ${{ github.head_ref || github.ref }}
+
+      - name: Setup PHP for agent dependencies
+        uses: shivammathur/setup-php@ec406be512d7077f68eed36e63f4d91bc006edc4 # v2.35.4
+        with:
+          php-version: '7.2'
+          tools: composer:v2
+
+      - name: Install dependencies
+        working-directory: agent
+        run: composer update --no-progress --no-interaction --prefer-dist
+
+      - name: Setup PHP for Box
+        uses: shivammathur/setup-php@ec406be512d7077f68eed36e63f4d91bc006edc4 # v2.35.4
+        with:
+          php-version: '8.4'
+          tools: box
+          ini-values: phar.readonly=0
+
+      - name: Build PHAR
+        run: scripts/build.sh
+        env:
+          COMPOSER_ROOT_VERSION: 0.1.0 # For reproducible PHAR builds
+
+      - name: Setup PHP for PHAR test
+        uses: shivammathur/setup-php@ec406be512d7077f68eed36e63f4d91bc006edc4 # v2.35.4
+        with:
+          php-version: '7.2'
+
+      - name: Test PHAR
+        run: php bin/sentry-agent help
+
+      - name: Commit PHAR
+        uses: EndBug/add-and-commit@a94899bca583c204427a224a7af87c02f9b325d5 # v9.1.4
+        with:
+          add: "bin/sentry-agent bin/sentry-agent.sig"
+          message: "Add PHAR artifact"
+          default_author: github_actions

.github/workflows/phpstan.yaml

@@ -15,12 +15,33 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
+
+      - name: Setup PHP
+        uses: shivammathur/setup-php@ec406be512d7077f68eed36e63f4d91bc006edc4 # v2.35.4```
+        with:
+          php-version: '8.4'
+
+      - name: Install dependencies
+        run: composer update --no-progress --no-interaction --prefer-dist
+
+      - name: Run script
+        run: vendor/bin/phpstan analyse
+
+  phpstan-agent:
+    name: PHPStan (agent)
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: ./agent
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
 
       - name: Setup PHP
         uses: shivammathur/setup-php@9e72090525849c5e82e596468b86eb55e9cc5401 # pin@2.32.0
         with:
-          php-version: '8.3'
+          php-version: '8.4'
 
       - name: Install dependencies
         run: composer update --no-progress --no-interaction --prefer-dist

.github/workflows/publish-release.yaml

@@ -0,0 +1,45 @@
+name: Prepare Release
+
+on:
+  workflow_dispatch:
+    inputs:
+      version:
+        description: Version to release
+        required: true
+      force:
+        description: Force a release even when there are release-blockers (optional)
+        required: false
+      merge_target:
+          description: Target branch to merge into. Uses the default branch as a fallback (optional)
+          required: false
+          default: main
+
+permissions:
+  contents: read
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    name: Release version
+    steps:
+      - name: Get auth token
+        id: token
+        uses: actions/create-github-app-token@a8d616148505b5069dccd32f177bb87d7f39123b # v2.1.1
+        with:
+          app-id: ${{ vars.SENTRY_RELEASE_BOT_CLIENT_ID }}
+          private-key: ${{ secrets.SENTRY_RELEASE_BOT_PRIVATE_KEY }}
+
+      - name: Checkout
+        uses: actions/checkout@v5
+        with:
+          token: ${{ steps.token.outputs.token }}
+          fetch-depth: 0
+
+      - name: Prepare release
+        uses: getsentry/action-prepare-release@v1
+        env:
+          GITHUB_TOKEN: ${{ steps.token.outputs.token }}
+        with:
+          version: ${{ github.event.inputs.version }}
+          force: ${{ github.event.inputs.force }}
+          merge_target: ${{ github.event.inputs.merge_target }}

.gitignore

@@ -1,6 +1,7 @@
 *.lock
+!agent/composer.lock
 package.xml
-/vendor
+vendor
 .idea
 .php-cs-fixer.cache
 .phpbench

.php-cs-fixer.dist.php

@@ -40,8 +40,8 @@
     ->setRiskyAllowed(true)
     ->setFinder(
         PhpCsFixer\Finder::create()
-                         ->in(__DIR__ . '/src')
-                         ->append([
-                             __DIR__ . '/sentry-agent',
+                         ->in([
+                             __DIR__ . '/src',
+                             __DIR__ . '/agent/src',
                          ])
     );

README.md

@@ -34,7 +34,7 @@ The agent is configured as a custom HTTP client for the [PHP](https://github.com
 ```php
 Sentry\init([
     'dsn' => '___PUBLIC_DSN___',
-    'http_client' => new Sentry\Agent\Transport\AgentClient(),
+    'http_client' => new \Sentry\Agent\Transport\AgentClient(),
 ]);
 ```
 

agent/box.json

@@ -0,0 +1,6 @@
+{
+    "main": "src/sentry-agent.php",
+    "output": "../bin/sentry-agent",
+    "alias": "sentry-agent.phar",
+    "timestamp": "20250904"
+}

agent/composer.json

@@ -0,0 +1,48 @@
+{
+    "name": "sentry/sentry-agent-internal",
+    "type": "library",
+    "description": "Sentry Agent for PHP (https://sentry.io)",
+    "homepage": "https://sentry.io",
+    "license": "MIT",
+    "authors": [
+        {
+            "name": "Sentry",
+            "email": "accounts@sentry.io"
+        }
+    ],
+    "require": {
+        "php": "^7.2|^8.0",
+        "ext-json": "*",
+        "clue/mq-react": "^1.6",
+        "react/http": "^1.11",
+        "react/socket": "^1.16",
+        "sentry/sentry": "^4.15.0"
+    },
+    "autoload": {
+        "psr-4": {
+            "Sentry\\Agent\\": "src/"
+        }
+    },
+    "require-dev": {
+        "phpstan/phpstan": "1.12.5",
+        "phpunit/phpunit": "^8.5|^9.6"
+    },
+    "autoload-dev": {
+        "psr-4": {
+            "Sentry\\Agent\\Tests\\": "tests/"
+        }
+    },
+    "scripts": {
+        "check": [
+            "@phpstan",
+            "@tests"
+        ],
+        "tests": "vendor/bin/phpunit --verbose",
+        "phpstan": "vendor/bin/phpstan analyse"
+    },
+    "config": {
+        "sort-packages": true,
+        "autoloader-suffix": "SentryAgentChecksum"
+    },
+    "prefer-stable": true
+}