- Enhanced die() function with environment context and stack trace - Added detailed error output with line numbers and file paths - Improved check_dependencies with installation guides - Enhanced PHP syntax validation with full error details - Added verbose error messages to manifest, tabs, and paths validations - Updated validate_all to show error summaries (full output in verbose mode) - Updated smoke_test with detailed PHP error reporting - Updated ENTERPRISE.md with verbose error examples - All error messages now provide actionable troubleshooting steps Co-authored-by: jmiller-moko <230051081+jmiller-moko@users.noreply.github.com>
114 lines
3.5 KiB
Bash
Executable File
114 lines
3.5 KiB
Bash
Executable File
#!/usr/bin/env bash
|
|
|
|
# ============================================================================
|
|
# Copyright (C) 2025 Moko Consulting <hello@mokoconsulting.tech>
|
|
#
|
|
# This file is part of a Moko Consulting project.
|
|
#
|
|
# SPDX-License-Identifier: GPL-3.0-or-later
|
|
#
|
|
# This program is free software; you can redistribute it and/or modify
|
|
# it under the terms of the GNU General Public License as published by
|
|
# the Free Software Foundation; either version 3 of the License, or
|
|
# (at your option) any later version.
|
|
#
|
|
# This program is distributed in the hope that it will be useful,
|
|
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
# GNU General Public License for more details.
|
|
#
|
|
# You should have received a copy of the GNU General Public License
|
|
# along with this program (./LICENSE.md).
|
|
# ============================================================================
|
|
|
|
# ============================================================================
|
|
# FILE INFORMATION
|
|
# ============================================================================
|
|
# DEFGROUP: Script.Validate
|
|
# INGROUP: Code.Quality
|
|
# REPO: https://github.com/mokoconsulting-tech/moko-cassiopeia
|
|
# PATH: /scripts/validate/php_syntax.sh
|
|
# VERSION: 01.00.00
|
|
# BRIEF: Validates PHP syntax using php -l on all PHP files
|
|
# NOTE: Requires PHP CLI to be available
|
|
# ============================================================================
|
|
|
|
set -euo pipefail
|
|
|
|
# Validation timeout (seconds) - prevents hanging on problematic files
|
|
TIMEOUT="${VALIDATION_TIMEOUT:-30}"
|
|
SRC_DIR="${SRC_DIR:-src}"
|
|
|
|
json_escape() {
|
|
python3 -c 'import json,sys; print(json.dumps(sys.argv[1]))' "$1"
|
|
}
|
|
|
|
[ -d "${SRC_DIR}" ] || {
|
|
printf '{"status":"fail","error":%s}
|
|
' "$(json_escape "src directory missing")"
|
|
exit 1
|
|
}
|
|
|
|
if ! command -v php >/dev/null 2>&1; then
|
|
printf '{"status":"ok","warning":"php_not_available","src_dir":%s}
|
|
' "$(json_escape "${SRC_DIR}")"
|
|
echo "php_syntax: ok (php not available)"
|
|
exit 0
|
|
fi
|
|
|
|
failed=0
|
|
checked=0
|
|
failed_files=()
|
|
failed_errors=()
|
|
|
|
while IFS= read -r -d '' f; do
|
|
checked=$((checked+1))
|
|
|
|
# Capture actual error output
|
|
error_output=""
|
|
|
|
# Use timeout if available to prevent hangs
|
|
if command -v timeout >/dev/null 2>&1; then
|
|
if ! error_output=$(timeout "${TIMEOUT}" php -l "$f" 2>&1); then
|
|
failed=1
|
|
failed_files+=("$f")
|
|
failed_errors+=("$error_output")
|
|
fi
|
|
else
|
|
if ! error_output=$(php -l "$f" 2>&1); then
|
|
failed=1
|
|
failed_files+=("$f")
|
|
failed_errors+=("$error_output")
|
|
fi
|
|
fi
|
|
done < <(find "${SRC_DIR}" -type f -name '*.php' -print0)
|
|
|
|
if [ "${failed}" -ne 0 ]; then
|
|
echo "ERROR: PHP syntax validation failed" >&2
|
|
echo "Files checked: ${checked}" >&2
|
|
echo "Files with errors: ${#failed_files[@]}" >&2
|
|
echo "" >&2
|
|
echo "Failed files and errors:" >&2
|
|
for i in "${!failed_files[@]}"; do
|
|
echo " File: ${failed_files[$i]}" >&2
|
|
echo " Error: ${failed_errors[$i]}" >&2
|
|
echo "" >&2
|
|
done
|
|
echo "" >&2
|
|
echo "To fix: Review and correct the syntax errors in the files listed above." >&2
|
|
echo "Run 'php -l <filename>' on individual files for detailed error messages." >&2
|
|
{
|
|
printf '{"status":"fail","error":"php_lint_failed","files_checked":%s,"failed_count":%s,"failed_files":[' "${checked}" "${#failed_files[@]}"
|
|
for i in "${!failed_files[@]}"; do
|
|
printf '%s' "$(json_escape "${failed_files[$i]}")"
|
|
[ "$i" -lt $((${#failed_files[@]} - 1)) ] && printf ','
|
|
done
|
|
printf ']}\n'
|
|
}
|
|
exit 1
|
|
fi
|
|
|
|
printf '{"status":"ok","files_checked":%s}
|
|
' "${checked}"
|
|
echo "php_syntax: ok"
|