phpstan with stubs

Author: Ferror

.github/workflows/ci.yaml

@@ -0,0 +1,42 @@
+name: CI
+
+on:
+  push: ~
+  pull_request: ~
+  workflow_dispatch: ~
+
+jobs:
+  tests:
+    runs-on: ubuntu-latest
+    name: CI - PHP ${{ matrix.php }}, Dependencies ${{ matrix.dependencies }}
+    env:
+      ASYNCAPI_VERSION: ${{ matrix.schema }}
+    strategy:
+      matrix:
+        php: [8.4]
+        dependencies: [lowest, highest]
+
+    steps:
+      - # Copies the repository files to the Action Runner
+        name: Checkout Repository
+        uses: actions/checkout@v4
+
+      - # Installs PHP and other necessary tools
+        name: Setup PHP
+        uses: shivammathur/[email protected]
+        with:
+          php-version: ${{ matrix.php }}
+
+      - # Installs and caches PHP dependencies
+        name: Install Dependencies
+        uses: ramsey/[email protected]
+        with:
+          dependency-versions: ${{ matrix.dependencies }}
+
+      - # Validates composer.json structure and required fields
+        name: Validate composer.json
+        run: composer validate --ansi --strict --no-check-publish
+
+      -
+        name: phpstan
+        run: vendor/bin/phpstan

.gitignore

@@ -0,0 +1,2 @@
+/vendor/
+/composer.lock

composer.json

@@ -0,0 +1,15 @@
+{
+    "name": "ferror/phpstan-datadog-env",
+    "autoload": {
+        "psr-4": {
+            "Ferror\\": "src/"
+        }
+    },
+    "require": {
+        "php": ">=8.3",
+        "datadog/dd-trace": "^1.6"
+    },
+    "require-dev": {
+        "phpstan/phpstan": "^2.1"
+    }
+}

phpstan.neon

@@ -0,0 +1,11 @@
+# phpstan.neon
+parameters:
+    level: max
+    paths:
+        - src
+    bootstrapFiles:
+        - vendor/autoload.php
+
+    # Include stubs for Datadog Trace Stubs
+    scanFiles:
+        - vendor/datadog/dd-trace/src/ddtrace_php_api.stubs.php

src/ExampleClass.php

@@ -0,0 +1,20 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Ferror;
+
+use DDTrace\Contracts\Span;
+use DDTrace\ScopeManager;
+
+final readonly class ExampleClass
+{
+    public function __construct(private Span $span)
+    {
+    }
+
+    public function test(ScopeManager $scopeManager): void
+    {
+        $scopeManager->activate($this->span);
+    }
+}