crasivo / bitrix-installer
Lightweight Composer project template to quickly prepare a 1C-Bitrix environment with public directory isolation.
v1.0.1
2026-07-25 20:29 UTC
Requires
- php: >=8.2
- ext-curl: *
- ext-gd: *
- ext-json: *
- ext-mbstring: *
- ext-mysqli: *
- ext-openssl: *
- ext-simplexml: *
- ext-zip: *
- ext-zlib: *
README
A lightweight Composer skeleton/adapter designed to quickly prepare a clean environment for 1C-Bitrix installation with public directory isolation.
🎯 Goal & Core Idea
This project is not a pre-packaged CMS installation. It is a minimalist adapter that prepares the target workspace and
dynamically downloads the official vendor scripts (bitrixsetup.php & restore.php) during composer create-project.
Key Design Decisions:
- Directory Isolation: Prepared for a secure structure where the web server root points to a
public/directory, isolating code files likevendor/and configuration files from the public web space. - Zero Bloat: Intentionally contains zero third-party Composer packages (like Symfony components, PSR libraries, ORMs). The project remains extremely lightweight and only checks for PHP version and required extensions.
- Dynamic Loading: No CMS source code is stored in this repository. Everything is fetched securely at install time
via Composer's
post-create-project-cmdhooks.
âš¡ Quick Start
To initialize a new Bitrix environment, run the standard Composer command:
composer create-project crasivo/bitrix-installer my-bitrix-site
What Happens Under the Hood:
- Composer verifies that your environment meets the minimum PHP version and extension requirements.
- The folder structure is prepared.
- The official installer scripts are dynamically downloaded:
bitrixsetup.php-> downloaded asindex.phpfor direct installation launcher.restore.php-> downloaded for backup restoration.restore.php.debug-> created for debugging.
📄 License
This project is open-source and licensed under the MIT License.