scripts/console.php

   1 #!/usr/bin/env php
   2 <?php
   3 /*
   4  * StatusNet - the distributed open-source microblogging tool
   5  * Copyright (C) 2009, StatusNet, Inc.
   6  *
   7  * This program is free software: you can redistribute it and/or modify
   8  * it under the terms of the GNU Affero General Public License as published by
   9  * the Free Software Foundation, either version 3 of the License, or
  10  * (at your option) any later version.
  11  *
  12  * This program is distributed in the hope that it will be useful,
  13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15  * GNU Affero General Public License for more details.
  16  *
  17  * You should have received a copy of the GNU Affero General Public License
  18  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  19  */
  20
  21 # Abort if called from a web server
  22
  23 define('INSTALLDIR', realpath(dirname(__FILE__) . '/..'));
  24
  25 $helptext = <<<ENDOFHELP
  26 console.php - provide an interactive PHP interpreter for testing
  27
  28 ENDOFHELP;
  29
  30 require_once INSTALLDIR.'/scripts/commandline.inc';
  31
  32 if (function_exists('posix_isatty')) {
  33     define('CONSOLE_INTERACTIVE', posix_isatty(0));
  34 } else {
  35     // Windows? Assume we're on a terminal. :P
  36     define('CONSOLE_INTERACTIVE', false);
  37 }
  38 if (CONSOLE_INTERACTIVE) {
  39     define('CONSOLE_READLINE', function_exists('readline'));
  40 }
  41
  42 if (CONSOLE_READLINE && CONSOLE_INTERACTIVE && file_exists(CONSOLE_HISTORY)) {
  43     define(CONSOLE_HISTORY, getenv("HOME") . "/.statusnet_console_history");
  44     readline_read_history(CONSOLE_HISTORY);
  45 }
  46
  47 function read_input_line($prompt)
  48 {
  49     if (CONSOLE_INTERACTIVE) {
  50         if (CONSOLE_READLINE) {
  51             $line = readline($prompt);
  52             readline_add_history($line);
  53             return $line;
  54         } else {
  55             return readline_emulation($prompt);
  56         }
  57     } else {
  58         return fgets(STDIN);
  59     }
  60 }
  61
  62 /**
  63  * On Unix-like systems where PHP readline extension is not present,
  64  * -cough- Mac OS X -cough- we can shell out to bash to do it for us.
  65  * This lets us at least handle things like arrow keys, but we do not
  66  * get any entry history. :(
  67  *
  68  * Shamelessly ripped from when I wrote the same code for MediaWiki. :)
  69  * @author Brion Vibber <brion@status.net>
  70  *
  71  * @param string $prompt
  72  * @return mixed string on success, false on fail or EOF
  73  */
  74 function readline_emulation($prompt)
  75 {
  76     if(file_exists(trim(shell_exec('which bash')))) {
  77         $encPrompt = escapeshellarg($prompt);
  78         $command = "read -er -p $encPrompt && echo \"\$REPLY\"";
  79         $encCommand = escapeshellarg($command);
  80         $metaCommand = "bash -c $encCommand";
  81
  82         // passthru passes our STDIN and TTY to the child...
  83         // We can pull the returned string via output buffering.
  84         ob_start();
  85         $retval = false;
  86         passthru($metaCommand, $retval);
  87         $line = ob_get_contents();
  88         ob_end_clean();
  89
  90         if ($retval == 0) {
  91             return $line;
  92         } elseif ($retval == 127) {
  93             // Could not execute bash even though we thought we saw it.
  94             // Shell probably spit out an error message, sorry :(
  95             // Fall through to fgets()...
  96         } else {
  97             // EOF/ctrl+D
  98             return false;
  99         }
 100     }
 101
 102     // Fallback... we'll have no editing controls, EWWW
 103     if (feof(STDIN)) {
 104         return false;
 105     }
 106     print $prompt;
 107     return fgets(STDIN);
 108 }
 109
 110 function console_help()
 111 {
 112     print "Welcome to StatusNet's interactive PHP console!\n";
 113     print "Type some PHP code and it'll execute...\n";
 114     print "\n";
 115     print "Hint: return a value of any type to output it via var_export():\n";
 116     print "  \$profile = new Profile();\n";
 117     print "  \$profile->find();\n";
 118     print "  \$profile->fetch();\n";
 119     print "  return \$profile;\n";
 120     print "\n";
 121     print "Note that PHP is cranky and you can easily kill your session by mistyping.\n";
 122     print "\n";
 123     print "Type ctrl+D or enter 'exit' to exit.\n";
 124 }
 125
 126
 127 print "StatusNet interactive PHP console... type ctrl+D or enter 'exit' to exit.\n";
 128 $prompt = common_config('site', 'name') . '> ';
 129 while (!feof(STDIN)) {
 130     $line = read_input_line($prompt);
 131     if ($line === false) {
 132         print "\n";
 133         break;
 134     } elseif ($line !== '') {
 135         try {
 136             if (trim($line) == 'exit') {
 137                 break;
 138             } elseif (trim($line) == 'help') {
 139                 console_help();
 140                 continue;
 141             }
 142
 143             // Let's do this!
 144             $result = eval($line);
 145             if ($result === false) {
 146                 // parse error
 147             } elseif ($result === null) {
 148                 // no return
 149             } else {
 150                 // return value from eval'd code
 151                 var_export($result);
 152             }
 153         } catch(Exception $e) {
 154             print get_class($e) . ": " . $e->getMessage() . "\n";
 155         }
 156     }
 157     print "\n";
 158 }
 159
 160 if (CONSOLE_READLINE && CONSOLE_INTERACTIVE) {
 161     @readline_write_history(CONSOLE_HISTORY);
 162 }