feat: Add PHP language support

php/.codeqlmanifest.json

@@ -0,0 +1,12 @@
+{
+  "provide": [
+    "ql/*/qlpack.yml"
+  ],
+  "versionPolicies": {
+    "default": {
+      "requireChangeNotes": true,
+      "committedPrereleaseSuffix": "dev",
+      "committedVersion": "nextPatchRelease"
+    }
+  }
+}

php/Makefile

@@ -0,0 +1,196 @@
+.PHONY: all build clean test install help extractor dbscheme ql-library check fmt lint doc
+
+# Detect OS and architecture
+UNAME_S := $(shell uname -s)
+UNAME_M := $(shell uname -m)
+
+ifeq ($(UNAME_S),Linux)
+    EXE :=
+    DYLIB_EXT := so
+    OS := linux
+else ifeq ($(UNAME_S),Darwin)
+    EXE :=
+    DYLIB_EXT := dylib
+    OS := macos
+else ifeq ($(OS),Windows_NT)
+    EXE := .exe
+    DYLIB_EXT := dll
+    OS := windows
+endif
+
+# Paths
+EXTRACTOR_DIR := extractor
+QL_LIB_DIR := ql/lib
+QL_SRC_DIR := ql/src
+BUILD_DIR := build
+TARGET_DIR := $(EXTRACTOR_DIR)/target
+CARGO := cargo
+CODEQL := codeql
+
+# Targets
+EXTRACTOR_BIN := $(TARGET_DIR)/release/codeql-extractor-php$(EXE)
+DBSCHEME_FILE := $(QL_LIB_DIR)/php.dbscheme
+TREE_SITTER_QL := $(QL_LIB_DIR)/codeql/php/ast/internal/TreeSitter.qll
+
+# Default target
+all: help
+
+## help: Show this help message
+help:
+	@echo "PHP Language Support for CodeQL - Makefile"
+	@echo ""
+	@echo "Targets:"
+	@sed -n 's/^##//p' ${MAKEFILE_LIST} | column -t -s ':' | sed -e 's/^/ /'
+	@echo ""
+	@echo "Examples:"
+	@echo "  make build              Build the extractor"
+	@echo "  make clean              Remove build artifacts"
+	@echo "  make test               Run all tests"
+	@echo "  make install            Install extractor and libraries"
+
+## build: Build extractor, database schema, and QL library
+build: extractor dbscheme ql-library
+	@echo "✓ Build complete"
+
+## extractor: Build the PHP extractor (Rust binary)
+extractor: $(EXTRACTOR_BIN)
+	@echo "✓ Extractor built: $(EXTRACTOR_BIN)"
+
+$(EXTRACTOR_BIN): $(EXTRACTOR_DIR)/src/*.rs $(EXTRACTOR_DIR)/Cargo.toml
+	@echo "Building PHP extractor..."
+	cd $(EXTRACTOR_DIR) && $(CARGO) build --release
+	@echo "✓ Extractor binary ready"
+
+## dbscheme: Generate database schema from tree-sitter grammar
+dbscheme: $(DBSCHEME_FILE)
+	@echo "✓ Database schema generated: $(DBSCHEME_FILE)"
+
+$(DBSCHEME_FILE): $(EXTRACTOR_BIN)
+	@echo "Generating database schema..."
+	@mkdir -p $(dir $(DBSCHEME_FILE))
+	$(EXTRACTOR_BIN) generate \
+		--dbscheme $(DBSCHEME_FILE) \
+		--library $(TREE_SITTER_QL)
+	@echo "✓ Schema generation complete"
+
+## ql-library: Generate QL library from tree-sitter grammar
+ql-library: $(TREE_SITTER_QL)
+	@echo "✓ QL library generated: $(TREE_SITTER_QL)"
+
+$(TREE_SITTER_QL): $(EXTRACTOR_BIN) $(DBSCHEME_FILE)
+	@echo "QL library already generated with schema"
+	@echo "✓ QL library ready"
+
+## check: Check code without building
+check:
+	@echo "Checking code..."
+	cd $(EXTRACTOR_DIR) && $(CARGO) check
+	@echo "✓ Code check passed"
+
+## fmt: Format Rust code
+fmt:
+	@echo "Formatting code..."
+	cd $(EXTRACTOR_DIR) && $(CARGO) fmt
+	@echo "✓ Code formatted"
+
+## lint: Run clippy linter
+lint:
+	@echo "Running clippy..."
+	cd $(EXTRACTOR_DIR) && $(CARGO) clippy --all-targets --all-features -- -D warnings
+	@echo "✓ Linting complete"
+
+## doc: Generate documentation
+doc:
+	@echo "Generating documentation..."
+	cd $(EXTRACTOR_DIR) && $(CARGO) doc --no-deps --open
+	@echo "✓ Documentation generated"
+
+## test: Run all tests
+test: unit-tests query-tests
+	@echo "✓ All tests passed"
+
+## unit-tests: Run Rust unit tests
+unit-tests:
+	@echo "Running Rust unit tests..."
+	cd $(EXTRACTOR_DIR) && $(CARGO) test --release
+	@echo "✓ Unit tests passed"
+
+## query-tests: Run CodeQL query tests
+query-tests: build
+	@echo "Running CodeQL query tests..."
+	@if command -v codeql >/dev/null 2>&1; then \
+		$(CODEQL) test run $(QL_SRC_DIR)/queries/security --verbose; \
+		echo "✓ Query tests passed"; \
+	else \
+		echo "⚠ CodeQL CLI not found, skipping query tests"; \
+	fi
+
+## install: Install extractor and register libraries
+install: build
+	@echo "Installing extractor..."
+	@mkdir -p $(HOME)/.codeql/extractors/php/
+	@cp $(EXTRACTOR_BIN) $(HOME)/.codeql/extractors/php/
+	@cp codeql-extractor.yml $(HOME)/.codeql/extractors/php/
+	@echo "✓ Extractor installed to $(HOME)/.codeql/extractors/php/"
+	@echo ""
+	@echo "QL Libraries:"
+	@echo "  - Library pack: $(QL_LIB_DIR)/qlpack.yml"
+	@echo "  - Query pack: $(QL_SRC_DIR)/qlpack.yml"
+	@echo ""
+	@echo "To use with CodeQL, set CODEQL_PYTHONPATH:"
+	@echo "  export CODEQL_PYTHONPATH=$$(pwd)/$(QL_LIB_DIR)"
+
+## clean: Remove build artifacts
+clean:
+	@echo "Cleaning build artifacts..."
+	@rm -rf $(TARGET_DIR)
+	@rm -rf $(BUILD_DIR)
+	@rm -f $(DBSCHEME_FILE)
+	@rm -f $(TREE_SITTER_QL)
+	@cd $(EXTRACTOR_DIR) && $(CARGO) clean
+	@echo "✓ Clean complete"
+
+## clean-all: Remove all generated files
+clean-all: clean
+	@echo "Removing all generated files..."
+	@find . -name "*.lock" -delete
+	@find . -name ".DS_Store" -delete
+	@echo "✓ Full clean complete"
+
+## dist: Create distribution package
+dist: build
+	@echo "Creating distribution package..."
+	@mkdir -p $(BUILD_DIR)/php
+	@cp -r $(QL_LIB_DIR) $(BUILD_DIR)/php/
+	@cp -r $(QL_SRC_DIR) $(BUILD_DIR)/php/
+	@cp $(EXTRACTOR_BIN) $(BUILD_DIR)/php/extractor
+	@cp codeql-extractor.yml $(BUILD_DIR)/php/
+	@cp README.md $(BUILD_DIR)/php/
+	@tar -czf $(BUILD_DIR)/php-support.tar.gz -C $(BUILD_DIR) php
+	@echo "✓ Distribution package created: $(BUILD_DIR)/php-support.tar.gz"
+
+## extract-example: Extract example PHP file
+extract-example: build
+	@echo "Extracting example PHP file..."
+	@mkdir -p build/trap
+	@echo '<?php echo "Hello, World!"; ?>' > build/example.php
+	$(EXTRACTOR_BIN) extract \
+		--output build/trap \
+		--source-root build/example.php \
+		--verbose
+	@echo "✓ Extraction complete. TRAP files in build/trap/"
+
+## profile: Profile the extractor
+profile: build
+	@echo "Profiling extractor..."
+	cd $(EXTRACTOR_DIR) && $(CARGO) build --profile=bench
+	@echo "✓ Profiling complete"
+
+## version: Print version information
+version:
+	@echo "CodeQL PHP Extractor Version Information"
+	@echo "========================================"
+	@$(EXTRACTOR_BIN) --version
+	@$(EXTRACTOR_BIN) diag
+
+.SILENT: help version