Skip to content

Security: Maatify/bootstrap

Security

SECURITY.md

๐Ÿ›ก๏ธ Security Policy

Library: maatify/bootstrap Maintainer: Mohamed Abdulalim (@megyptm) Organization: Maatify.dev License: MIT Version: 1.0.2 Last Updated: 2025-11-13


๐Ÿ” Supported Versions

Version Supported Notes
1.0.x โœ… Security patches + environment safety fixes
<1.0.0 โŒ Unsupported

maatify/bootstrap is a foundational package โ€” only the latest version receives updates.


โš ๏ธ Reporting a Vulnerability

If you discover a security vulnerability, please do NOT open a public GitHub issue. Instead, report it privately through:

๐Ÿ“ฎ Secure Channels

Provide:

  • Description + severity
  • Steps to reproduce
  • PHP version + OS
  • Affected versions
  • Suggested mitigation (optional)

๐Ÿ• Response Process

Step Action Target Time
1๏ธโƒฃ Acknowledge report โ‰ค 24 hours
2๏ธโƒฃ Verify & reproduce 2โ€“5 business days
3๏ธโƒฃ Patch + internal review 5โ€“7 days
4๏ธโƒฃ Coordinate disclosure & release patch After fix is deployed

๐Ÿง  Security Considerations for bootstrap

Because this package handles environment loading, startup logic, and safe mode, its security demands are strict:

๐Ÿ”’ Environment Handling Safety

  • No .env file may override pre-existing system variables.
  • .env.local and .env.testing must never load in production.
  • Test environments must load via immutable snapshots only.
  • Sensitive environment values are never logged.

๐Ÿงฑ Initialization Integrity

  • Bootstrap::init() must never cause side effects outside its scope.
  • Timezone auto-setup must use safe, validated values.
  • Safe Mode protects production environments from accidental misconfiguration.

โš™๏ธ Error Handling

  • Exception traces sanitized before logging.
  • No leaking of sensitive environment paths.
  • Consistent behavior across CLI, web, and CI environments.

๐Ÿšซ What Must Never Happen

  • Overwriting CI credentials
  • Overwriting PHPUnit test variables
  • Loading .env.testing in production
  • Logging actual .env secrets

๐Ÿ” Security Best Practices for Users

  • Protect .env.local, .env.testing, .env files from public access.

  • On production servers:

    • Disable file browsing
    • Ensure .env is outside document root if possible
    • Use environment variables from systemd, Docker, or CI
  • Do not store credentials inside repository

  • Review Safe Mode warnings in your CI pipeline


๐Ÿช„ Contact

For questions regarding security:

๐Ÿ“ง security@maatify.dev
๐ŸŒ https://www.maatify.dev/security


ยฉ 2025 Maatify.dev โ€” Maintained by @megyptm
Unified Bootstrap & Environment Loader for all Maatify PHP Libraries


There arenโ€™t any published security advisories