add args and usage examples

mass-rename.php

@@ -1,7 +1,13 @@
 <?php
 
+//	Copyright (c) 2020 DBMXPCA Technologies. All rights reserved.
+//	www.dbmxpca.com
+//	Date Created: May 18, 2020
+//	Last Updated: May 18, 2020
 
 $dirToTraverse = -1;
+$regex_search = "";
+$replace_str = "";
 
 function GET_DIR_CONTENTS($dir, &$results = array()) {
     $files = scandir($dir);
@@ -19,6 +25,25 @@ function GET_DIR_CONTENTS($dir, &$results = array()) {
     return $results;
 }
 
+function ECHO_USAGE(){
+	
+	global $argv;
+	
+	echo "\n > Usage:\n";
+	echo "       \"php " . $argv[0] . " <t-dir> <search-regex> <replace-str>\"\n";
+	echo "       where <t-dir> is the directory to traverse and\n";
+	echo "       <search-regex> is the regular expression to\n";
+	echo "       search for, and <replace-str> is the raw string\n";
+	echo "       to replace the search-regex with. Note that\n";
+	echo "       <replace-str> is NOT a regular expression.\n";
+	
+	echo "\n > Examples:\n";
+	echo "   >    \"php " . $argv[0] . " . /.[a-z]+/ .jpg\"\n";
+	echo "   >    \"php " . $argv[0] . " . /.[a-zA-Z]+/ .jpg\"\n";
+	echo "   >    \"php " . $argv[0] . " . /.[a-zA-Z0-9]+/ .jpg\"\n";
+	
+}
+
 //	=================================================================
 
 if (isset($argv[1])){
@@ -27,6 +52,48 @@ if (isset($argv[1])){
 	echo " > Check passed; Traversal Directory = [" . $dirToTraverse . "]\n";
 }
 
+else{
+	
+	echo " > Check FAILED; Missing Traversal Directory!\n";
+	
+	ECHO_USAGE();
+	
+	echo "\n > Script terminated.\n";
+	exit(1);
+}
+
+if (isset($argv[2])){
+	
+	$regex_search = $argv[2];
+	echo " > Check passed; Search RegEx = \"" . $regex_search . "\"\n";
+}
+
+else{
+	
+	echo " > Check FAILED; Missing Search RegEx!\n";
+	
+	ECHO_USAGE();
+	
+	echo "\n > Script terminated.\n";
+	exit(1);
+}
+
+if (isset($argv[3])){
+	
+	$replace_str = $argv[3];
+	echo " > Check passed; Replacement String = \"" . $replace_str . "\"\n";
+}
+
+else{
+	
+	echo " > Check FAILED; Missing Search RegEx!\n";
+	
+	ECHO_USAGE();
+	
+	echo "\n > Script terminated.\n";
+	exit(1);
+}
+
 $contents = array();
 GET_DIR_CONTENTS($dirToTraverse, $contents);