mvccore/example-helloworld-portable

MvcCore - Example - Hello World For Portable Packing - basic application packing demonstration.

v5.3.0 2024-11-21 16:40 UTC

Requires

• php: >=5.4.0
• mrclay/minify: 2.3.*
• mvccore/packager: ^5.3

BSD-3-Clause

• Tom Flidr

• application
• building
• packing
• portable
• hello-world
• mvccore
• single-file

README

Skeleton for MvcCore Hello World (mvccore/example-helloworld) example portable packing/building.

Instalation

# load hello world portable project skeleton
composer create-project mvccore/example-helloworld-portable ./my-helloworld-portable 

# go to portable project skeleton directory
cd my-helloworld-portable

# load hello world project
composer create-project mvccore/example-helloworld ./development

Packed Result Features

• Result is completely portable - ./example-helloworld-portable/release/index.php
• Result application is currently packed in strict package mode
• All packing configurations are included in ./build/configs directory
• Packed with Packager library (mvccore/packager), all packing ways possible:
  • PHAR file
    • standard PHAR package with whole development directory content
  • PHP file
    • strict package
      • everything is contained in result index.php
      • only .htaccess or web.config are necessary to use mod_rewrite
    • preserve package
      • result index.php file contains PHP files, PHTML templates but no CSS/JS/fonts or images
      • all wrapped file system functions are looking inside package first, then they try to read data from HDD
    • preserve hdd
      • result index.php file contains PHP files, PHTML templates but no CSS/JS/fonts or images
      • all wrapped file system functions are looking on HDD first, then they try to read data from package inself
    • strict hdd
      • result index.php file contains only PHP files, but PHTML templates, all CSS/JS/fonts and images are on HDD
      • no PHP file system function is wrapped

Build

1. Prepare Application

• go to ./my-helloworld-portable/development
• clear everything in ./Var/Tmp/
• uncomment ->SetCompiled(\MvcCore\Application::COMPILED_SFU) in ./index.php
• visit all application routes where are different JS/CSS bundles groups to generate ./Var/Tmp/ content for result app
• run build process

2. Run Build Process

Linux:

# go to project build dir
cd ./my-helloworld-portable/build
# run build process into single PHP file
sh make.sh

Windows:

# go to project build dir
cd ./my-helloworld-portable/build
# run build process into single PHP file
make.cmd

Browser:

# visit script `make-php.php` in your project build directory:
http://localhost/my-helloworld-portable/build/make-php.php
# now run your result in:
http://localhost/my-helloworld-portable/release/