Changeset 185 for trunk/trax/trax.php

Timestamp:

03/23/06 09:45:48 (6 years ago)

Author:

haas

Message:

more adaptable

Files:

• trunk/trax/trax.php (modified) (5 diffs)

trunk/trax/trax.php

@@ -1 +1 @@
 <?php
 /**
- *  Copy Pear directory data_dir/PHPonTrax/data/ to user's work area
+ *  Create Trax application work area
  *
  *  (PHP 5)
@@ -12 +12 @@
  */
 
+/**
+ *  Define where to find files to copy to the work area
+ *
+ *  Set automatically by the Pear installer when you install Trax with
+ *  the <b>pear install</b> command.  If you are prevented from using
+ *  <b>pear install</b>, change "@DATA-DIR@/PHPonTrax" by hand to the
+ *  full filesystem path of the location where you installed the Trax
+ *  distribution 
+ */
+define("SOURCE_DIR", "@DATA-DIR@/PHPonTrax/data/");
+
 function trax() {
-    //  Set default destination directory
-    $dstdir = "./";
 
     //  Get command line argument, if any
-    if (array_key_exists('argc',$GLOBALS) && ($GLOBALS['argc'] > 1)) {
-
-        //  Check for excess arguments
-        if ($GLOBALS['argc'] > 2) {
-            echo "unrecognized command argument ".$GLOBALS['argv'][2]."\n";
-            return;
-        }
-
-        //  Destination directory on command line
-        $dstdir = $GLOBALS['argv'][1];
-
-        //  Guarantee it ends with '/'
-        if (substr($dstdir,-1,1) != '/') {
-            $dstdir .= '/';
-        }
-        if (!create_dir($dstdir)) {
-            return;
-        }
-    }
-    $srcdir = "@DATA-DIR@/PHPonTrax/data/";
+    if (!array_key_exists('argc',$GLOBALS)
+        || ($GLOBALS['argc'] < 2)) {
+        usage();                // print Usage message and exit
+    }
+
+    //  Check for excess arguments
+    if ($GLOBALS['argc'] > 2) {
+        echo "unrecognized command argument ".$GLOBALS['argv'][2]."\n";
+        usage();
+    }
+
+    //  Destination directory on command line
+    $dstdir = $GLOBALS['argv'][1];
+
+    //  Guarantee it ends with '/'
+    if (substr($dstdir,-1,1) != '/') {
+        $dstdir .= '/';
+    }
+    if (!create_dir($dstdir)) {
+        return;
+    }
+
+    $srcdir = SOURCE_DIR;
     //  copy source directory to destination directory
     copy_dir($srcdir,$dstdir);
@@ -43 +55 @@
 /**
  *  Copy a directory with all its contents
+ *
+ *  When a file whose filename ends '.log' is created, its permissions
+ *  are set to be world writable.
  *  @param string $src_path  Path to source directory
  *  @param string $dst_path  Path to destination directory
@@ -108 +123 @@
                 return false;
             }
+
+            //  Log files need to be world writeable
+            if (substr($src_file,-4,4) == '.log') {
+                chmod($dst_path . $src_file, 0666);
+            }
             echo  "$dst_path$src_file created\n";
         } else {
@@ -170 +190 @@
 
 /**
+ *  Output a Usage message and exit
+ */
+function usage() {
+    echo <<<END
+Usage: @BIN-DIR@/trax /path/to/your/app
+
+Description:
+    The 'trax' command creates a new Trax application with a default
+    directory structure and configuration at the path you specify.
+
+Example:
+    trax /var/www/html
+
+    This generates a skeletal Trax installation in /var/www/html.
+    See the README in the newly created application to get going.
+
+END;
+    exit;
+}
+
+/**
  *  Main program
  */