Server-side Application PHP Methods
Here is an example below of the mycontroller.php PHP script implementing the MyController class having a myaction action.
<?php
namespace app\controller;
class MyController extends \AppController {
static protected function action_myaction() {
$request = new \Request();
$postValue = $request->my_param;
$response = new \Response();
$response->my_response = $postValue;
return $response;
}
}
?>
This controller action reads the value of the my_param POST parameter and returns a JSON object with a property named my_response and a value matching the my_param parameter value.
You can notice in this example that the namespace is set to app\controller. It matches the folder in which the mycontroller.php script file must be located, i.e. in the INSTALL_DIR/applications/default/app/controller folder if the running application is the Starter Application (default subfolder).
Access to the data stored into the database of the application is simplified thanks to the ZnetDK PHP classes \DAO and \SimpleDao, both based on the PHP PDO class.
The ZnetDK class \DAO allows to achieve complex database operations, in particular when data is to be selected from multiple SQL tables.
See below an example of custom DAO class.
<?php
namespace app\model;
class TaskDAO extends \DAO {
protected function initDaoProperties() {
$this->table = "zdkapp_tasks";
$this->query = "SELECT tas.*, tas.id AS task_id, usr.user_name,
IF(tas.status_id < 3 AND tas.end_date < CURDATE(), 1, 0) AS late,
IF(tas.status_id < 3, 0, 1) AS display_priority
FROM tasks AS tas
INNER JOIN zdk_users AS usr ON usr.user_id = tas.user_id";
$this->dateColumns = array('begin_date', 'end_date', 'creation_date');
}
public function setNotFinishedAsFilter() {
$this->filterClause = 'WHERE tas.status_id != ?';
$this->setFilterCriteria(3);
}
}
?>
The ZnetDK class \SimpleDAO offers an easy and quick way to operate on a single SQL table or view.
Here is an example of usage of the \SimpleDAO class.
<?php
$contactsDao = new \SimpleDAO('contacts');
$rowsFound = array();
$rowCount = $contactsDao->getRows($rowsFound, 'name');
?>
The ZnetDK framework provides useful utility classes in PHP for data conversion, formatted dates, data writing to log files, ...
getCurrentW3CDate()
<?php
echo \General::getCurrentW3CDate();
?>
getFilledMessage()
<?php
echo \General::getFilledMessage('Your car is %1 and %2.','blue','yellow');
/* Display: Your car is blue and yellow. */
?>
toMoney()
<?php
$myMoney = \Convert::toMoney(3451.7399);
?>
W3CtoLocaleDate()
<?php
$myDate = \Convert::W3CtoLocaleDate('2013-04-22');
?>
The following PHP constants can be used in the views and in the controllers to get absolute or relative path of specific ZnetDK folders.
ZNETDK_APP_ROOTAbsolute path of the folder containing the files of the running application.
<?php
/* If ZnetDK is installed into the /home/hosting999/www/znetdk/ folder
and if the Starter Application is currently running... */
echo ZNETDK_APP_ROOT; // Display of /home/hosting999/www/znetdk/applications/default
?>
ZNETDK_APP_URIRelative path of the directory containing the web resources of the application.
<?php
/* If ZnetDK is installed into the /home/hosting999/www/znetdk/ folder
and if the Starter Application is currently running... */
echo ZNETDK_APP_URI; // Display of /znetdk/applications/default/public/
?>
ZNETDK_ROOT_URIRelative path of the root directory of ZnetDK (installation folder).
<?php
/* If ZnetDK is installed into the /home/hosting999/www/znetdk/ folder
and if the Starter Application is currently running... */
echo ZNETDK_ROOT_URI; // Display of /znetdk/
?>