'plugin_config' => [
    'phound_sqlite_path' => '.phan/phound.sqlite',
],
'plugins' => [
    'PhoundPlugin',
    // ... other plugins
],

./phan
# Database is written to the path specified in phound_sqlite_path

# Find all usages of a method
sqlite3 .phan/phound.sqlite "SELECT callsite FROM callsites WHERE element = '\Phan\CodeBase::getMethodByFQSEN' AND type = 'method' ORDER BY callsite"

# Find all usages of a property
sqlite3 .phan/phound.sqlite "SELECT callsite FROM callsites WHERE element = '\Phan\CodeBase::class_fqsen_class_map_map' AND type = 'prop' ORDER BY callsite"

# Find all usages of a class constant
sqlite3 .phan/phound.sqlite "SELECT callsite FROM callsites WHERE element = '\Phan\Issue::TypeMismatchReturn' AND type = 'const' ORDER BY callsite"

# Get signature of a method
sqlite3 -header .phan/phound.sqlite "
  SELECT fqsen, kind, type, visibility, is_static, filepath, lineno, docblock
  FROM signatures WHERE fqsen = '\Phan\CodeBase::getMethodByFQSEN'"

# Get its parameters
sqlite3 -header .phan/phound.sqlite "
  SELECT name, type, is_variadic, is_reference, is_optional, default_repr
  FROM parameters WHERE fqsen = '\Phan\CodeBase::getMethodByFQSEN' ORDER BY idx"

CLASS='\Phan\Language\Type'

# Parent classes
sqlite3 .phan/phound.sqlite "SELECT parent FROM class_relationships WHERE child = '$CLASS' ORDER BY parent"

# Child classes (subclasses)
sqlite3 .phan/phound.sqlite "SELECT child FROM class_relationships WHERE parent = '$CLASS' ORDER BY child"

# Interfaces implemented
sqlite3 .phan/phound.sqlite "SELECT interface FROM class_interfaces WHERE class = '$CLASS' ORDER BY interface"

# Traits used
sqlite3 .phan/phound.sqlite "SELECT trait FROM class_traits WHERE class = '$CLASS' ORDER BY trait"

# For interfaces — sub-interfaces
sqlite3 .phan/phound.sqlite "SELECT child FROM interface_relationships WHERE parent = '$CLASS' ORDER BY child"

# For interfaces — parent interfaces
sqlite3 .phan/phound.sqlite "SELECT parent FROM interface_relationships WHERE child = '$CLASS' ORDER BY parent"

# Classes implementing an interface (with file locations)
sqlite3 -header .phan/phound.sqlite "
  SELECT ci.class, c.filepath
  FROM class_interfaces ci LEFT JOIN classes c ON ci.class = c.name
  WHERE ci.interface = '\Phan\PluginV3'
  ORDER BY ci.class"

# Subclasses of a class (with file locations)
sqlite3 -header .phan/phound.sqlite "
  SELECT cr.child, c.filepath
  FROM class_relationships cr LEFT JOIN classes c ON cr.child = c.name
  WHERE cr.parent = '\Phan\Language\Type'
  ORDER BY cr.child"

# Search by name pattern (SQL LIKE syntax)
sqlite3 -header .phan/phound.sqlite "
  SELECT fqsen, kind, filepath, lineno
  FROM signatures WHERE name LIKE '%CodeBase%'
  ORDER BY fqsen LIMIT 50"

# Filter by kind
sqlite3 -header .phan/phound.sqlite "
  SELECT fqsen, kind, filepath, lineno
  FROM signatures WHERE name LIKE 'get%' AND kind = 'method'
  ORDER BY fqsen LIMIT 50"

# All symbols defined in a file
sqlite3 -header .phan/phound.sqlite "
  SELECT fqsen, kind, type, visibility, is_static, lineno
  FROM signatures WHERE filepath = 'src/Phan/CodeBase.php'
  ORDER BY lineno"

# Only methods
sqlite3 -header .phan/phound.sqlite "
  SELECT fqsen, kind, type, visibility, is_static, lineno
  FROM signatures WHERE filepath = 'src/Phan/CodeBase.php' AND kind = 'method'
  ORDER BY lineno"

# Find unreferenced symbols (methods, properties, constants — excluding functions)
sqlite3 -header .phan/phound.sqlite "
  SELECT s.fqsen, s.kind, s.visibility, s.filepath, s.lineno, s.name
  FROM signatures s
  LEFT JOIN callsites c ON s.fqsen = c.element AND c.type = (
    CASE s.kind
      WHEN 'method' THEN 'method'
      WHEN 'property' THEN 'prop'
      WHEN 'constant' THEN 'const'
      ELSE ''
    END
  )
  WHERE c.element IS NULL
    AND s.kind != 'function'
  ORDER BY s.filepath, s.lineno
  LIMIT 100"

  AND s.name NOT IN ('__construct','__destruct','__call','__callStatic',
      '__get','__set','__isset','__unset','__sleep','__wakeup',
      '__serialize','__unserialize','__toString','__invoke',
      '__set_state','__clone','__debugInfo')
  AND NOT (s.kind = 'method' AND s.visibility = 'public' AND s.name LIKE 'test%')
  AND NOT (s.kind = 'constant' AND s.name = 'class')

# Which files have the most symbols?
sqlite3 .phan/phound.sqlite "SELECT filepath, COUNT(*) as cnt FROM signatures GROUP BY filepath ORDER BY cnt DESC LIMIT 20"

# Most-referenced methods
sqlite3 .phan/phound.sqlite "SELECT element, COUNT(*) as cnt FROM callsites WHERE type = 'method' GROUP BY element ORDER BY cnt DESC LIMIT 20"

# All protected methods in a class
sqlite3 .phan/phound.sqlite "SELECT name, type FROM signatures WHERE class_fqsen = '\Phan\CodeBase' AND visibility = 'protected' ORDER BY name"

# Classes with no subclasses (leaf classes)
sqlite3 .phan/phound.sqlite "SELECT c.name, c.filepath FROM classes c LEFT JOIN class_relationships cr ON c.name = cr.parent WHERE cr.child IS NULL ORDER BY c.name"

# Start on default port (4846)
./phan --daemonize-tcp-port default

# Start on specific port
./phan --daemonize-tcp-port 4846

# With quick mode for faster analysis (less thorough)
./phan --daemonize-tcp-port 4846 --quick

# Analyze a single file
php phan_client -l src/MyClass.php

# Analyze with JSON output
php phan_client -l src/MyClass.php -m json

# Analyze with a non-default port
php phan_client --daemonize-tcp-port 4850 -l src/MyClass.php

# Analyze an unsaved buffer (flycheck-style)
php phan_client -l src/MyClass.php -f /tmp/MyClass_modified.php

# Analyze a file via netcat
echo '{"method":"analyze_files","files":["src/MyClass.php"],"format":"json"}' | nc 127.0.0.1 4846

{
  "method": "analyze_files",
  "files": ["src/MyClass.php"],
  "format": "json"
}

{
  "status": "ok",
  "issue_count": 2,
  "issues": [
    {
      "type": "issue",
      "check_name": "PhanUndeclaredVariable",
      "description": "Variable $x is undeclared",
      "severity": 10,
      "location": {
        "path": "src/MyClass.php",
        "lines": { "begin": 42 }
      }
    }
  ]
}

echo '{
  "method": "analyze_files",
  "files": ["src/MyClass.php"],
  "format": "json",
  "temporary_file_mapping_contents": {
    "src/MyClass.php": "<?php\nclass MyClass {\n    public function test(): void {\n        $x = undefinedFunction();\n    }\n}\n"
  }
}' | nc 127.0.0.1 4846

function example() {
    $x = [1, 2, 3];
    '@phan-debug-var $x';
    // Phan reports: PhanDebugAnnotation $x has union type int[]
}

./phan -n myfile.php
# or via the daemon:
php phan_client -l myfile.php

#!/bin/bash
# Usage: type_at.sh <file> <line> <variable>
FILE="$1"
LINE="$2"
VAR="$3"

# Read the file and inject @phan-debug-var before the target line
CONTENTS=$(awk -v line="$LINE" -v var="$VAR" '
  NR == line { print "'"'"'@phan-debug-var $" var "'"'"';" }
  { print }
' "$FILE")

# Send to daemon with the modified contents
REQUEST=$(jq -n \
  --arg file "$FILE" \
  --arg contents "$CONTENTS" \
  '{method: "analyze_files", files: [$file], format: "json",
    temporary_file_mapping_contents: {($file): $contents}}')

echo "$REQUEST" | nc 127.0.0.1 4846 | jq '.issues[] | select(.check_name == "PhanDebugAnnotation") | .description'

# Analyze specific files without loading config (fast)
./phan -n file1.php file2.php

# Analyze with the test config
./phan -k tests/.phan_for_test/config.php file1.php file2.php

# Self-analysis
./phan

# AST dump for debugging
php tool/dump_ast.php --json file.php

// Suppress on next line
/** @suppress PhanTypeMismatchReturn */

// Suppress for entire file
/** @phan-file-suppress PhanUnreferencedMethod */

// Inline suppression
/* @phan-suppress-current-line PhanUndeclaredVariable */
/* @phan-suppress-next-line PhanUndeclaredVariable */

'@phan-debug-var $x';           // Single variable
'@phan-debug-var $x, $y';       // Multiple variables
'@phan-debug-var $arr[\'key\']'; // Array elements