Documentation PHP Decoder
ionCube Decoder & SourceGuardian Decoder for PHP — private, offline, and team‑ready. Use the graphical interface (GUI) or the CLI.
At a Glance
- Offline & Private — Your code never leaves your machine.
- Two Ways to Work — Graphical Interface for simplicity, CLI for automation.
- Batch‑friendly — Decode folders, automate in CI, get logs & checksums.
- Readable Output — Symbol tables rebuilt and common obfuscation layers removed where feasible.
- Cross‑Platform — Windows & Linux (64‑bit).
- Team‑Ready — Practical workflows for agencies and in‑house teams.
Supported Versions
| Engine | Versions |
|---|---|
| ionCube Loader | 10–14 |
| SourceGuardian | 11–15 |
| PHP | 5.6–8.3 |
Contents
- Quick Start
- Install
- System Requirements
- Graphical Interface (GUI)
- CLI Reference
- Workflows & CI
- Readable Output
- Logs & Checksums
- Performance Tips
- Security & Privacy
- Legal & Acceptable Use
- Licensing & Updates
- Purchasing & Payment
- Troubleshooting
- FAQ
- Support
Quick Start
UnZend runs fully offline on your machine. Start with the GUI for a guided experience or use the CLI for scripting. Verify your setup, then decode a single file and a small folder.
1) Verify the install
unzend --version
unzend --help
2) Decode one file (CLI, ionCube)
unzend decode --engine ioncube \
--input /path/to/locked.php \
--out ./decoded/
3) Decode a folder (CLI, recursive)
Point --input to a directory. UnZend will process supported files and preserve relative structure in --out.
unzend decode --engine sourceguardian \
--input ./project-locked/ \
--out ./project-decoded/
Install
Windows (64‑bit)
- Run the installer or extract the provided archive to a location of your choice.
- Open Windows Terminal or PowerShell.
- Optionally, add the installation directory to your
PATHenvironment variable for global access. - Verify with
unzend --version.
Linux (64‑bit)
- Extract the archive to a suitable path (e.g.,
/opt/unzendor your home directory). - Add the
unzendbinary folder to yourPATHin~/.bashrcor~/.zshrc. - Make sure the binary is executable:
chmod +x unzend. - Verify with
unzend --version.
Note: Depending on your plan, you may be prompted to activate on first run. Follow on‑screen instructions or the Welcome email you received after purchase.
System Requirements
- Windows or Linux (64-bit)
- Modern CPU; 8 GB RAM recommended
- Sufficient disk space for decoded output and logs
- Runs fully offline on your machine
Graphical Interface (GUI)
No coding experience is required. The GUI lets you launch jobs, select files or folders, choose the decoding engine, set an output location, and view results and logs — all offline on your machine.
Start a new job
- Open UnZend and choose New Decode.
- Pick Engine: ionCube or SourceGuardian.
- Set Input to a file or a folder.
- Set Output directory (UnZend preserves structure).
- Optionally enable logs and checksums.
- Click Start to run.
Monitor & review
- See progress in real‑time with file counters.
- Open the Job Log to review summaries, warnings, and any skipped files.
- Use Open Output to jump to the decoded folder.
- Run New Job with different settings if needed.
Tip: For mixed projects (both ionCube and SourceGuardian), run separate jobs per engine.
CLI Reference
UnZend is CLI‑first. Run unzend --help for the complete list of commands and flags. Common patterns are shown below.
Decode a single file
unzend decode --engine ioncube \
--input /path/locked.php \
--out ./decoded/
Decode a folder
unzend decode --engine sourceguardian \
--input ./locked-src/ \
--out ./decoded-src/
Dry‑run & logging (recommended)
Before large jobs, perform a quick run and inspect logs. Use logging options from --help to capture summaries and checksums.
Workflows & CI
UnZend is designed for repeatable engineering workflows. The examples below demonstrate common patterns for automation.
Simple Bash script
#!/usr/bin/env bash
set -euo pipefail
INPUT=${1:-./locked}
OUTPUT=${2:-./decoded}
# Preview
unzend --version
# Decode
unzend decode --engine ioncube --input "$INPUT" --out "$OUTPUT"
# Basic sanity check
php -l $(find "$OUTPUT" -type f -name '*.php') | tee decode-php-lint.log
GitHub Actions (example)
name: Decode with UnZend
on: [workflow_dispatch]
jobs:
decode:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Install PHP
uses: shivammathur/setup-php@v2
with:
php-version: '8.2'
- name: Run UnZend
run: |
unzend --version
unzend decode --engine ioncube \
--input ./locked \
--out ./decoded
- name: Lint Decoded PHP
run: |
find ./decoded -name "*.php" -print0 | xargs -0 -n1 php -l
Readable Output
- Rebuilds symbol tables where feasible to restore developer‑friendly names.
- Removes common obfuscation layers for long‑term maintainability.
- Preserves project structure to minimize diff noise.
- Generates logs and checksums to aid auditing.
Logs & Checksums
- Job summary: Counts of processed, decoded, and skipped files.
- Warnings & reasons: Notes for files that could not be decoded (e.g., unsupported version).
- Checksums: Optional hashes to verify integrity of input and output sets.
- Storage: Logs are saved next to the output or to a custom path you specify.
Performance Tips
- Use a local SSD for both input and output directories.
- Exclude large non‑PHP directories from input paths.
- Run small samples first to validate settings before full runs.
- Keep your OS up‑to‑date; ensure sufficient free disk space for outputs and logs.
Security & Privacy
UnZend runs locally on your machine. Your code remains on your device, and jobs execute offline. Review logs on your own system and store outputs where your team policies require.
- Local only: No need to upload source files anywhere to decode.
- Project structure preserved: Keep changes reviewable and auditable.
- Team workflows: Save logs alongside outputs to meet internal audit requirements.
Legal & Acceptable Use
Read before you decode
Use UnZend only to decode software you own or for which you have the owner’s written permission to recover. You are responsible for complying with copyright law and all local regulations.
Licensing & Updates
- Includes a software license for UnZend v3.x (devices and update window depend on plan).
- Documentation and quick‑start guides are provided with your purchase.
- Email support from the engineers who build the decoder.
Purchasing & Payment
UnZend accepts crypto payments only. Step‑by‑step payment instructions are shown at checkout after selecting your plan.
Troubleshooting
Common issues
- Unsupported loader or PHP version: Check the Supported Versions table above.
- Permission denied: Ensure the output directory is writable and binaries are executable.
- Mixed engines: When a project mixes ionCube and SourceGuardian, run separate passes or set
--engineaccordingly. - PHP syntax warnings: Run
php -lover decoded files and fix any project‑specific issues.
Self‑check steps
- Confirm your download matches the expected checksum (if provided).
- Run on a small sample before a full batch.
- Review logs for skipped files and reasons.
- Ensure you are decoding only what you own or have permission for.
FAQ
Do I need programming knowledge to use UnZend?
No coding experience is required. UnZend includes a graphical interface (GUI) that guides you through decoding without writing a single command.
- With the GUI you can: choose ionCube or SourceGuardian, pick files or folders as input, set an output directory, enable logs/checksums, and start the job. Progress and results are shown on screen, and you can open the output folder directly.
- For power users: the command‑line interface (CLI) mirrors the GUI and is ideal for automation scripts and CI pipelines.
If you prefer, you can begin with the GUI to validate your settings, then copy the equivalent CLI command into your scripts for repeatable workflows.
Does UnZend run offline?
Yes. UnZend runs entirely on your machine. Your code stays private.
Which platforms are supported?
Windows and Linux (64‑bit).
Which PHP versions are supported?
PHP 5.6 through 8.3.
How do I pay?
Crypto payments only. Step‑by‑step instructions are provided at checkout.
Where can I learn about PHP environments?
See the official PHP website for version information and environment details relevant to decoded projects.
Support
Your purchase includes documentation, quick‑start guides, and email support from the engineers who work on the decoder. Use the contact method provided after checkout, or the contact form on our website.