The PHP Repl
I simply wanted an online repl that allowed me to play with multiline php scripts.
There's already a console-based repl
php -a, but it and many other
console-based repls are not great for multiline snippets.
Folks have even been using
eval/index.php as a sandboxed, php eval script to power their own services. Pretty awesome!
The online version of PHPepl is sandboxed. The exposed
eval is sandboxed at the server configuration layer
plus some blacklisting of methods at the application level via PHP-Sandbox.
This has, of course, crippled the tool a bit – as you can't run code that has blacklisted methods. For an unsandboxed experience, I recommend serving this app locally.
Big thanks to Elijah Horton, creator of PHP-Sandbox, for his great sandbox and assistance in maintaining PHPepl.
Running it locally
If you use vagrant, you can
vagrant up within the phpepl root. This will spawn a virtual machine serving phpepl
You can also do
vagrant plugin install vagrant-hostsupdater if you need to fetch the hostname from
/etc/hosts or another host file.
If you use Docker, you can run
./docker-bootstrap to start a container that serves the app using PHP5 and Apache.
To view the served app, visit the IP address of the host. Note, if you're using boot2docker, you need to visit the ip
found via the
boot2dock ip command.
To serve this application locally, you'll need any php-capable web server:
Grab the source code for phpepl: fork this repo, download the source as a zip, or install via npm
npm install phpepl.
You can then point your web server to serve files from the
phpepl/ root folder
- Namely, you should be able to visit the index page (
http://localhost(include a custom port if necessary)
http://localhost:8000, assuming your server is configured to listen to port 8000.
You'll then have free reign to execute any commands.
If you hit any errors or if someone hacked the repl and it goes down, give me a shout on Twitter: @mrjoelkemp
Close to 100 people use this REPL every day; don't ruin it for them. Please play nice.
This app uses Browserify for bundling and Grunt for task running.
If you'd like to tinker around with the code, you can do the following:
- Clone the repo
npm installin the root directory
- Point your browser to your localhost (assuming you have the app being served locally)
js/phpepl.js is the main script for the website. This gets built into a hashed
which is referenced by
The php evaluation code is in
That endpoint checks for the existence of a
PHPEPL_PROD environment variable
(which is set on the production hosts) for sandboxing. Locally, you won't
have that set, so you'll have the unsandboxed version by default.
- With grunt running, that change should rebuild the app and you can just refresh the page.
Copyright (C) 2014 by Joel Kemp email@example.com and others
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.