2e24a40d68
- Fix: Notifiable-Trait zum User-Model hinzugefuegt (behebt notify()-500er) - Installer: SMTP-Verbindungstest mit EsmtpTransport + Ueberspringen-Link - Admin: Neuer E-Mail-Tab mit SMTP-Konfiguration + Verbindungstest - Admin: Lazy Quill-Initialisierung (nur sichtbare Locale wird geladen) - Uebersetzungen: 17 neue Mail-Keys in allen 6 Sprachen Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
58 lines
1.7 KiB
Markdown
Executable File
58 lines
1.7 KiB
Markdown
Executable File
Analyzes php-code for side-effects.
|
|
|
|
When code has no side-effects it can e.g. be used with `eval($code)` in the same process without interfering.
|
|
[Side-effects are classified](https://github.com/staabm/side-effects-detector/blob/main/lib/SideEffect.php) into categories to filter them more easily depending on your use-case.
|
|
|
|
## Install
|
|
|
|
`composer require staabm/side-effects-detector`
|
|
|
|
## Usage
|
|
|
|
Example:
|
|
|
|
```php
|
|
use staabm\SideEffectsDetector\SideEffectsDetector;
|
|
|
|
$code = '<?php version_compare(PHP_VERSION, "8.0", ">=") or echo("skip because attributes are only available since PHP 8.0");';
|
|
|
|
$detector = new SideEffectsDetector();
|
|
// [SideEffect::STANDARD_OUTPUT]
|
|
var_dump($detector->getSideEffects($code));
|
|
```
|
|
|
|
In case functions are called which are not known to have side-effects - e.g. userland functions - `null` is returned.
|
|
|
|
```php
|
|
use staabm\SideEffectsDetector\SideEffectsDetector;
|
|
|
|
$code = '<?php userlandFunction();';
|
|
|
|
$detector = new SideEffectsDetector();
|
|
// [SideEffect::MAYBE]
|
|
var_dump($detector->getSideEffects($code));
|
|
```
|
|
|
|
Code might have multiple side-effects:
|
|
|
|
```php
|
|
use staabm\SideEffectsDetector\SideEffectsDetector;
|
|
|
|
$code = '<?php include "some-file.php"; echo "hello world"; exit(1);';
|
|
|
|
$detector = new SideEffectsDetector();
|
|
// [SideEffect::SCOPE_POLLUTION, SideEffect::STANDARD_OUTPUT, SideEffect::PROCESS_EXIT]
|
|
var_dump($detector->getSideEffects($code));
|
|
```
|
|
|
|
|
|
## Disclaimer
|
|
|
|
Non goals are:
|
|
- find the best possible answer for all cases
|
|
- add runtime dependencies
|
|
|
|
If you are in need of a fully fledged side-effect analysis, use more advanced tools like PHPStan.
|
|
|
|
Look at the test-suite to get an idea of [supported use-cases](https://github.com/staabm/side-effects-detector/blob/main/tests/SideEffectsDetectorTest.php).
|