{"id":124,"date":"2011-11-09T13:06:21","date_gmt":"2011-11-09T05:06:21","guid":{"rendered":"https:\/\/www.techcoil.com\/blog\/?p=124"},"modified":"2018-09-03T21:16:10","modified_gmt":"2018-09-03T13:16:10","slug":"generate-php-codes-with-php","status":"publish","type":"post","link":"https:\/\/www.techcoil.com\/blog\/generate-php-codes-with-php\/","title":{"rendered":"Generate PHP codes with PHP"},"content":{"rendered":"

Throughout my programming years, I observed similar trends in code structures and I felt that being able to generate them automatically will greatly reduce development time. <\/p>\n

Although there are many code generation software on the web, coding one for your own usage can be simpler and more convenient, especially when you had written custom functions that your generated codes will utilize. <\/p>\n

In this post, I shall discuss my recent experience in creating a PHP code generator for my own usage. <\/p>\n

A simple case study<\/h3>\n

Suppose that given a class name and a comma-delimited string of variable names:<\/p>\n

\r\n<?php\r\n$classname = 'Person';\r\n$variables = 'age, name';\r\n?>\r\n<\/pre>\n
We want to generate a POJO equivalence in PHP automatically, which resembles the following form:<\/p>\n
\r\n<?php\r\nclass Person {\r\n\r\n    private $name;\r\n    private $age;\r\n\r\n    public function getName() {\r\n        return $this->name;\r\n    } \/\/ end public function getName()\r\n\r\n    public function setName($name) {\r\n        $this->name = $name;\r\n    } \/\/ end public function setName($name)\r\n\r\n    public function getAge() {\r\n        return $this->age;\r\n    } \/\/ end public function getAge()\r\n\r\n    public function setAge($age) {\r\n        $this->age = $age;\r\n    } \/\/ end public function setAge($age)\r\n} \/\/ end class Person\r\n\r\n?><\/pre>\n
Perform the necessary work<\/h3>\n
Capitalise the first character of the variable name<\/h4>\n
To capitalise the first character of the variable name to form the getXXX and setXXX methods, we can use the ucfirst<\/code> function.<\/p>\n
\r\n<?php\r\n\/\/ Form the method name of the getter method \r\n$getterMethodName = 'get' . ucfirst('age');\r\n?>\r\n<\/pre>\n
Get the end of line<\/h4>\n
The end of line is represented differently in different operating systems. Use the php constant PHP_EOL<\/code><\/strong> instead of \\r<\/strong> or \\n<\/strong> to output the end of line in a cross platform manner.<\/p>\n
\r\n<?php\r\n\/\/ Variable contains the end of line character(s).\r\n$endOfLine = PHP_EOL;\r\n?>\r\n<\/pre>\n
Get the tab character<\/h4>\n
The tab character is represented with the \\t<\/strong> literal. To output the tab character, enclose it with double quotes instead of single quotes. Using single quotes will display two characters \\<\/strong> and t<\/strong> instead of the tab character.<\/p>\n
\r\n<?php\r\n\/\/ Variable contains the tab character\r\n$tab = "\\t";\r\n\/\/ Variable contains the \\ and t characters\r\n$slashAndT = '\\t';\r\n?>\r\n<\/pre>\n
Write the codes to file<\/h4>\n
To write the codes to file, we can use the fopen<\/code> and fwrite<\/code> functions.<\/p>\n
\r\n<?php\r\n\/\/ Save the generated file to a sibling folder of the running script\r\n$generatedFileUrl  = dirname($_SERVER['SCRIPT_FILENAME']);\r\n$generatedFileUrl .= '\/generated-codes\/' . $className . '.inc.php';\r\n$fp = fopen($generatedFileUrl, 'w+');\r\n    \r\n\/\/ Write the start script tag\r\nfwrite($fp, '<?php' . PHP_EOL);\r\n?>\r\n<\/pre>\n
A sample (Plain Old PHP Object) POPO code generation script<\/h3>\n
The following is a sample script that I wrote for generating POPOs using the above-mentioned PHP features. Since this is a script to help developers, I did not include error handling to filter invalid class names or variable names. If you use it the right way, it can be helpful to you. \ud83d\ude42<\/p>\n
\r\n<?php\r\n\r\n$className = '';\r\n$variableNames = '';\r\n\r\nif (isset($_POST['text_class_name']) && isset($_POST['text_variable_names'])) {\r\n    \r\n    $className = trim($_POST['text_class_name']);\r\n    $variableNames = str_replace(' ', '', trim($_POST['text_variable_names']));\r\n\r\n    $variableNamesArray = explode(',', $variableNames);\r\n    \r\n    \/\/ Save the generated file to a sibling folder of the running script\r\n    $generatedFileUrl  = dirname($_SERVER['SCRIPT_FILENAME']);\r\n    $generatedFileUrl .= '\/generated-codes\/' . $className . '.inc.php';\r\n    $fp = fopen($generatedFileUrl, 'w+');\r\n    \r\n    \/\/ Write the start script tag\r\n    fwrite($fp, '<?php' . PHP_EOL);\r\n    \r\n    fwrite($fp, 'class ' . $className . ' {' . PHP_EOL . PHP_EOL);\r\n    \r\n    \/\/ Output the instance variables\r\n    foreach($variableNamesArray as $variableName) {\r\n        fwrite($fp, "\\t" . 'private $' . $variableName . ';' . PHP_EOL);\r\n    }\r\n    \r\n    fwrite($fp, PHP_EOL);\r\n    \r\n    \/\/ Output the getter and setter methods\r\n    foreach ($variableNamesArray as $variableName) {\r\n        \r\n        $ucVariableName = ucfirst($variableName);\r\n        \r\n        \/\/ getter \r\n        fwrite($fp, "\\tpublic function get" . $ucVariableName . '() {' . PHP_EOL);\r\n        fwrite($fp, "\\t\\t" . 'return $this->' . $variableName . ';' . PHP_EOL );\r\n        fwrite($fp, "\\t} \/\/ end function get" . $ucVariableName . '()' . PHP_EOL . PHP_EOL);\r\n        \r\n        \/\/ setter \r\n        fwrite($fp, "\\tpublic function set" . $ucVariableName . '($' . $variableName . ') {' . PHP_EOL);\r\n        fwrite($fp, "\\t\\t" . '$this->' . $variableName . ' = $' . $variableName . ';' .  PHP_EOL);\r\n        fwrite($fp, "\\t} \/\/ end function set" . $ucVariableName . '($' . $variableName . ')' . PHP_EOL . PHP_EOL);\r\n        \r\n    } \/\/ end foreach\r\n    \r\n    fwrite($fp, '} \/\/ end class ' . $className . PHP_EOL);\r\n    fwrite($fp, '?>');\r\n    \r\n} \/\/ end if\r\n\r\n?>\r\n<!DOCTYPE html PUBLIC "-\/\/W3C\/\/DTD XHTML 1.0 Strict\/\/EN" "http:\/\/www.w3.org\/TR\/xhtml1\/DTD\/xhtml1-strict.dtd">\r\n<html xmlns="http:\/\/www.w3.org\/1999\/xhtml" xml:lang="en" lang="en">\r\n<head>\r\n    <title>Create Plain Old PHP Object<\/title>\r\n<\/head>\r\n<body>\r\n<h1>Create Plain Old PHP Object<\/h1>\r\n<form method="post" action="<?php echo $_SERVER["SCRIPT_NAME"];?>">\r\n<fieldset>\r\n<label>Class name: <\/label>\r\n<input type="text" name="text_class_name" value="<?php echo $className;?>"\/>\r\n<\/fieldset>\r\n<fieldset>\r\n<label>Variable name(s), comma-delimited: <\/label>\r\n<input type="text" name="text_variable_names" value="<?php echo $variableNames;?>"\/>\r\n<\/fieldset>\r\n<input type="submit" id="submitButton" name="submitButton" value="Submit"\/>\r\n<\/form>\r\n<\/body>\r\n<\/html>\r\n<\/pre>\n\n