Skip to content

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 WorkGraphical 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

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 PATH environment variable for global access.
  • Verify with unzend --version.

Linux (64‑bit)

  • Extract the archive to a suitable path (e.g., /opt/unzend or your home directory).
  • Add the unzend binary folder to your PATH in ~/.bashrc or ~/.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.

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 --engine accordingly.
  • PHP syntax warnings: Run php -l over 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.

Back to top ↑