Download the PHP package phpsoftbox/requisites without Composer

On this page you can find all versions of the php package phpsoftbox/requisites. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Example code of phpsoftbox/requisites

Informations about the package requisites

Requisites

phpsoftbox/requisites хранит изменяемые наборы реквизитов в JSON, но оставляет их типизированными на уровне приложения: для каждого набора известны форма, правила валидации, вариант схемы и версия структуры.

Компонент подходит не только для реквизитов компании. Его можно использовать для паспортных данных, заявлений, договоров и других наборов полей, состав которых зависит от страны, типа владельца или бизнес-сценария.

Минимальная версия PHP — 8.5.

С чего начать

Документация рассчитана на последовательное чтение:

  1. 01 — Первое подключение — основные понятия, таблица, форма, validator, профиль и полный цикл сохранения.
  2. 02 — Managed lifecycle — несколько профилей, selector policies, кастомный ORM storage, payload migrations и CLI backfill.
  3. 03 — Обновление существующего проекта — поведенческие изменения, пошаговый перенос и production checklist.

Если вы впервые видите компонент, начните с главы 01. Глава 02 намеренно не повторяет базовые понятия, а глава 03 рассчитана на читателя, который сначала познакомился с текущей архитектурой.

Какую проблему решает компонент

Представим, что у компании могут быть российские или казахстанские реквизиты. У этих вариантов разные поля и правила, а структура сохранённых данных со временем меняется.

Requisites добавляет поверх JSON:

Стабильные доменные поля, которые участвуют в индексах и SQL-фильтрах, лучше хранить обычными колонками. Requisites предназначен для составных и изменяемых наборов данных.

Рекомендуемый API

Для нового кода используется managed lifecycle:

Основной write-метод — validateAndSave(). Он:

Низкоуровневые storage, schema, validation и migration classes остаются доступны для специализированной инфраструктуры и совместимости. При их прямом использовании orchestration и проверка payload становятся ответственностью приложения.

Payload migrations

Команда для предварительной проверки:

Пример целевого backfill:

Перед запуском команды application container должен предоставлять BackfillMigrationRunner. Полная настройка описана в главе 02.

Готовые формы и правила

Для company profile доступны:

Form validation classes находятся в PhpSoftBox\Requisites\Validation\Form\Company.

Страновые rules находятся в:

Готовый класс следует подключать только после проверки, что его поля и ограничения совпадают с контрактом приложения.

Проверка компонента

Из корня монорепозитория:

All versions of requisites with dependencies

PHP Build Version
Package Version
Requires php Version ^8.5
phpsoftbox/collection Version ^1.0
phpsoftbox/data-casting Version ^1.0
phpsoftbox/database Version ^1.0
phpsoftbox/filter Version ^1.0
phpsoftbox/forms Version ^1.0
phpsoftbox/orm Version ^1.0
phpsoftbox/validator Version ^1.0
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package phpsoftbox/requisites contains the following files

Loading the files please wait ...