Showing content from https://github.com/box-project/box below:
box-project/box: 📦🚀 Fast, zero config application bundler with PHARs.
Upgrading from Box2? Checkout the upgrade guide!
Goal
The Box application simplifies the PHAR building process. Out of the box (no pun intended), the application can do many great things:
- ⚡ Fast application bundling
- 🔨 PHAR isolation
- ⚙️ Zero configuration by default
- 🚔 Requirements checker
- 🚨 Friendly error logging experience
- 🔍 Retrieve information about the PHAR extension or a PHAR file and its contents (
box info
or box diff
)
- 🔐️ Verify the signature of an existing PHAR (
box verify
)
- 📝 Use Git tags and short commit hashes for versioning
- 🕵️️ Get recommendations and warnings about regarding your configuration (
box validate
)
- 🐳 Docker support (
box docker
)
For the full documentation see https://box-project.github.io/box.
Table of Contents
- Installation
- Phive
- Composer
- Homebrew
- GitHub
- Docker
- shivammathur/setup-php (GitHub Actions)
- Usage
- Configuration
- Base path (
base-path
)
- Main (
main
)
- Output (
output
)
- Permissions (
chmod
)
- Check requirements (
check-requirements
)
- Including files
- Force auto-discovery (
force-autodiscovery
)
- Files (
files
and files-bin
)
- Directories (
directories
and directories-bin
)
- Finder (
finder
and finder-bin
)
- Blacklist (
blacklist
)
- Excluding the Composer files (
exclude-composer-files
)
- Excluding dev files (
exclude-dev-files
)
- Map (
map
)
- Stub
- Stub (
stub
)
- Alias (
alias
)
- Shebang (
shebang
)
- Banner (
banner
)
- Banner file (
banner-file
)
- Forcing the timestamp (
timestamp
)
- Dumping the Composer autoloader (
dump-autoload
)
- Compactors (
compactors
)
- Annotations (
annotations
)
- PHP-Scoper (
php-scoper
)
- Compression algorithm (
compression
)
- Security
- Signing algorithm (
algorithm
)
- The private key (
key
)
- The private key password (
key-pass
)
- Metadata (
metadata
)
- Replaceable placeholders
- Replacements (
replacements
)
- Replacement sigil (
replacement-sigil
)
- Datetime placeholder (
datetime
)
- Datetime placeholder format (
datetime-format
)
- Pretty git commit placeholder (
git
)
- Git commit placeholder (
git-commit
)
- Short git commit placeholder (
git-commit-short
)
- Git tag placeholder (
git-tag
)
- Git version placeholder (
git-version
)
- Requirements checker
- Configuration
- PHP version requirements
- Extension configuration requirements
- Polyfills
- Integration with a custom stub
- Optimize your PHAR
- Review your files
- Compress your PHAR
- Optimize your code
- PHAR code isolation
- Why/Explanation
- Isolating the PHAR
- Debugging the scoping
- Docker support
- Symfony support
- Project files
- Project directory
- Cache
- Reproducible builds
- Creating a reproducible PHAR
- PHP-Scoper
- Composer
- Composer root version
- Composer autoload suffix
- Box
- PHAR alias
- Requirement Checker
- Box banner
- PHAR
- Usages
- PHAR signing best practices
- Built-in PHAR API
- How to sign your PHAR
- How it works
- Why it is bad
- How to (properly) sign your PHAR
- Create a new GPG-key
- Manually signing
- Generate the encryption key
- Secure your encryption key
- Sign your PHAR
- Verifying the PHAR signature
- Automatically sign in GitHub Actions
- FAQ
- What is the canonical way to write a CLI entry file?
- The shebang
- The PHP_SAPI check
- Autoloading Composer
- Detecting that you are inside a PHAR
- Building a PHAR with Box as a dependency
- Contributing
- Upgrade guide
- Backward Compatibility Promise (BCP)
- Credits
Usage
Creating a PHAR should be as simple as running box compile
(no config required!). It will however assume some defaults that you might want to change. Box will by default be looking in order for the files box.json
and box.json.dist
in the current working directory. A basic configuration could be for example changing the PHAR permissions:
{
"chmod": "0700"
}
You can then find more advanced configuration settings in the configuration documentation. For more information on which command or options is available, you can run:
box help
Contributing
The project provides a Makefile
in which the most common commands have been registered such as fixing the coding style or running the test.
make
Backward Compatibility Promise (BCP)
The policy is for the major part following the same as Symfony's one. Note that the code marked as @private
or @internal
are excluded from the BCP.
The text displayed by the commands (e.g. compile
or info
) or the content of the error/exception messages are also not subject to the BCP.
Credits
Project originally created by: Kevin Herrera (@kherge) which has now been moved under the Humbug umbrella.
RetroSearch is an open source project built by @garambo
| Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4