QIQ

QIQ (Quick Interpreter for Quasi-PHP, /kik/) is an implementation of the PHP language specification written in the Go programming language.

The goals of the project are:

• Deep dive into the PHP language syntax and the internals of its mode of operation
• Gain more experience in writing lexers, parser and interpreter
• Very long-term goal: Implement as many parts of the standard library and language features as needed to run a simple Laravel application 😓

More documentation:

• AST
• Features
• Internal workings
• Packages
• Development

Usage

Usage of ./qiq:
  -h            Show help
  -dev          Run in developer mode.
  -stats        Show statistics.
  -S string     Run with built-in web server. <addr>:<port>
  -t string     Specify document root <docroot> for built-in web server.
  -f string     Parse and execute <file>.

Parse file:
cat index.php | ./qiq or ./qiq -f index.php

Run web server:
./qiq -S localhost:8080 - Document root is current working directory
./qiq -S localhost:8080 -dev - Web server in developer mode
./qiq -S localhost:8080 -t /srv/www/html - Document root is /srv/www/html

Run official PHP phpt test cases

There are a lot of test cases in the source repository for PHP under the folder tests.
In order to test the QIQ implementation against this cases the binary qiqTester can be used.

Usage:

./qiqTester [-v(1|2)] [-only-failed] <list of directory or phpt-file>

Examples:

./qiqTester php-src/tests
./qiqTester -v2 php-src/tests/basic/001.phpt

Usage with Docker

If you want to test or use QIQ with Docker, we've got you covered!

You can use the latest version: (This is not recommended as it might by unstable):

docker pull ghcr.io/masterzydra/qiq:latest

Or use a specific version:

docker pull ghcr.io/masterzydra/qiq:v0.4.0

You can find all versions here.

Run the docker image

docker run -p 8080:8080 ghcr.io/masterzydra/qiq:latest

You can change the port used inside the container (default: 8080):

docker run -p 8081:8081 --env PORT=8081 ghcr.io/masterzydra/qiq:latest

You can change the document root (default: /var/www/html)

docker run -p 8080:8080 --env DOC_ROOT=/var/www/html/public ghcr.io/masterzydra/qiq:latest

You can run the QIQ server in development mode (default: false)

docker run -p 8080:8080 --env DEV=true ghcr.io/masterzydra/qiq:latest

You can also mount a local project into the container:

docker run -p 8080:8080 -v $(pwd):/var/www/html:z ghcr.io/masterzydra/qiq:latest

Used resources

For some part of this project, the following resources were used as a guide, inspiration, or concept:

• PHP Language Specification
• YouTube playlist Build a Custom Scripting Language In Typescript by tylerlaceby
• Book Crafting Interpreters by Robert Nystorm
• Book Writing An Interpreter In Go by Thorsten Ball