========================================================================
             phpQ EXAMPLE WORKSPACE & DEMO QUICKSTART
========================================================================

This example workspace is pre-configured so you can test compilation,
licensing, and bytecode encryption immediately without complex setup.

WORKSPACE DIRECTORY TREE:
------------------------------------------------------------------------
example/
│
├── 1_Run_Project_Encode.bat    <- Double-click to encode entire project
├── 2_Encode_Single_File.bat    <- Double-click to encode a single file
├── 3_Generate_License.bat      <- Double-click to generate web.lic key
├── 4_Check_Machine_ID.bat      <- Double-click to view host Machine ID
├── project.txt                 <- Sample project build configuration
├── source/                     <- Raw PHP source directory to protect
│   ├── index.php
│   ├── config.php
│   ├── app/
│   │   ├── Auth.php
│   │   └── Database.php
│   └── assets/                 <- Static assets copied verbatim
│       ├── style.css
│       └── logo.txt
└── README.txt                  <- This reference manual

------------------------------------------------------------------------
PRACTICAL WORKFLOWS:
------------------------------------------------------------------------

1. ENCODE FULL PROJECT (Recommended for real-world applications):
   - Double-click "1_Run_Project_Encode.bat".
   - phpQ reads "project.txt", compiles all PHP scripts in "source/"
     into AST-obfuscated bytecode, and copies "assets/" untouched.
   - The output is emitted to: "example\target-encrypted"

2. ENCODE STANDALONE FILE:
   - Double-click "2_Encode_Single_File.bat".
   - Output saved to: "example\file_encrypted\index.php"

3. ISSUE CUSTOM CRYPTOGRAPHIC LICENSE (web.lic):
   - Double-click "3_Generate_License.bat".
   - Generates "target-encrypted\web.lic" cryptographically bound to
     domain "dev-portal.3c3s.com" with expiration "2027-12-31".

4. QUERY HARDWARE MACHINE ID:
   - Double-click "4_Check_Machine_ID.bat".
   - Prints the 64-character SHA-256 hardware identifier.

------------------------------------------------------------------------
COMMAND LINE USAGE (CMD / POWERSHELL):
------------------------------------------------------------------------
Open CMD in the folder containing phpQ.exe and run:

  phpQ.exe example\project.txt
  phpQ.exe encode -s example\source\index.php -t example	arget\index.php
========================================================================
