PHPackages                             qschool/sandbox - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. qschool/sandbox

ActiveLibrary[Utility & Helpers](/categories/utility)

qschool/sandbox
===============

Helper library for sandbox and user code validation

07PHPCI failing

Since Jun 30Pushed 5y ago1 watchersCompare

[ Source](https://github.com/qschool/sandbox)[ Packagist](https://packagist.org/packages/qschool/sandbox)[ RSS](/packages/qschool-sandbox/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

Библиотека для создания автоматических тестов для задач
-------------------------------------------------------

[](#библиотека-для-создания-автоматических-тестов-для-задач)

Библиотека для автоматической проверка php заданий, присланных пользователем, с возможностью предварительной валидации и расчетом числа набранных баллов.

Использует библиотеку для запуска php-кода в безопасном окружении: [corveda/php-sandbox](https://github.com/Corveda/PHPSandbox)

Установка
---------

[](#установка)

Для установки просто добавляем зависимость в composer

```
composer require qschool/sandbox

```

#### Demo пример

[](#demo-пример)

Создаем новый класс с правилами

```
use QSchool\Sandbox\Rules\BaseRule;

class TaskRule extends BaseRule
{
    public function validate_code_has_a_var($code)
    {
        $this->assertTrue(strpos('$a', $code) === false, 'В вашем коде не объявлена переменная $a');
    }

    public function test_example_code($code)
    {
        $this->assertTrue(strpos('', $code) === false, 'Код содержит  вместо PHP_EOL', 3);
    }
}
```

Инициализируем валидатор, и проверяем задачу

```
$task = QSchool\Sandbox\TaskVerification::createByRule(new TaskRule(), $code, $maxPoints = 15);
```

Валидируем код на корректности, а затем проверяем задачи, при необходимости получаем ошибки и количество набранных баллов

```
try {

    if ($task->validate()) {
        // Валдиация кода прошла успешно

        $verificationResult = $task->verification();
        // баллов набрано: $points = $verificationResult->points();
        // допущенные ошибки: $mistakes = $verificationResult->mistakes();
    }

} catch (QSchool\Sandbox\Validator\ValidationException $exception) {
    // Ошибка валидации
}
```

Использование
-------------

[](#использование)

Правила удобно наследовать от `QSchool\Sandbox\Rules\BaseRule` класса, тогда в этих классах нужно описать методы для запуска теста

#### Класс Правила

[](#класс-правила)

- Методы с префиксом `validate` - это методы для предварительной валидации задачи
- Методы с префиксом `test` - для проверки (оценки) самого кода
- Метод проверки `assertTrue($condition, $errorMessage, $points)` - проверяет услоивие `$condition`, если оно ложно - то выбрасывается исключение `ValidationException`, текст этого исключения можно задать в параметре `$errorMessage`, количество теряемых баллов в параметре `$points`

#### Трейт WithSandbox

[](#трейт-withsandbox)

- Предоставляет метод `prepareSandbox` для конфигурации окружения phpSandbox
- Каждому запускаемому окружению добавляется свой уникальный namespace (см. `setUp`), для возможности запуска одного кода несколько раз
- Метод `setMessages` - позволяет устновить свой текст для сообщений ошибок phpSandbox, либо, вы можете переопределить все свойство `$messages`

Пример
------

[](#пример)

Пример использования находится в директории `example`, Просто меняйте содержимое examples/task.php и смотрите на результат работы

```
cd example
php index.php

```

###  Health Score

17

—

LowBetter than 6% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity4

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity33

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/1fece020e92df820d86cb2d1135974ba39bae3e6dba37a8a534c2d173a4896e3?d=identicon)[mvsvolkov](/maintainers/mvsvolkov)

---

Top Contributors

[![mvsvolkov](https://avatars.githubusercontent.com/u/8544605?v=4)](https://github.com/mvsvolkov "mvsvolkov (4 commits)")

### Embed Badge

![Health badge](/badges/qschool-sandbox/health.svg)

```
[![Health](https://phpackages.com/badges/qschool-sandbox/health.svg)](https://phpackages.com/packages/qschool-sandbox)
```

###  Alternatives

[moltin/laravel-cart

Shopping cart package

27624.9k](/packages/moltin-laravel-cart)[andriichuk/laracash

PHP Laravel Money Package

74108.2k1](/packages/andriichuk-laracash)[tobimori/kirby-dreamform

Kirby DreamForm is an opiniated form builder plugin for Kirby CMS 4+ that makes forms work like magic

578.2k1](/packages/tobimori-kirby-dreamform)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)