aagjalpankaj/logstan

PHPStan extension for Laravel applications to enforce consistent logging practices.

v0.1.1 2025-05-25 16:40 UTC

Requires

• php: ^8.2
• illuminate/support: ^11.0|^12.0
• laravel/prompts: ^0.3
• phpstan/phpstan: ^2.0
• symfony/console: ^7.0

Requires (Dev)

• laravel/pint: ^1.21
• pestphp/pest: ^3.8
• rector/rector: ^2.0

MIT

• consistency
• laravel
• logs
• dev
• PHPStan

README

About

Logstan is a PHPStan extension designed for Laravel applications to enforce consistent logging practices. It helps developers maintain standardized logs across their projects.

Installation | Usage | Logging standards

Installation

composer require --dev aagjalpankaj/logstan

Usage

Analyzing Logs

./vendor/bin/logstan analyse

This command will scan your application and report any inconsistencies or potential problems.

Getting Insights

./vendor/bin/logstan insights

This command provides insights about logs added in the application.

Help

For more information about available commands and options:

./vendor/bin/logstan --help

Logging standards covered

Log Message

• Non-empty messages required
• Maximum message length (character limit)
• Messages must start with uppercase letters
• No sensitive information in message content

Log Context

• Context must be an array
• Maximum of 10 context keys allowed
• Keys must be non-empty strings in snake_case format
• Values must be scalar or null (no arrays/objects are accepted)
• Maximum value length of 100 characters
• No sensitive information in context keys