adulau/cakephp2-php8
1
0
Fork 0
mirror of https://github.com/kamilwylegala/cakephp2-php8.git synced 2025-02-07 12:36:25 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

All CakeSchema doc blocks conform to coding standards.

Browse source 
As laid out here: http://book.cakephp.org/2.0/en/contributing/cakephp-coding-conventions.html#typehinting
This commit is contained in:
Brian Porter 2014-08-12 12:28:34 -05:00
parent f1d01732a5
commit 5c69ac5578
1 changed files with 56 additions and 55 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

111
lib/Cake/Model/CakeSchema.php
View file

@ -22,49 +22,49 @@ App::uses('ConnectionManager', 'Model');
App::uses('File', 'Utility'); App::uses('File', 'Utility');
/** /**
* Base Class for Schema management * Base Class for Schema management.
* *
* @package Cake.Model * @package Cake.Model
*/ */
class CakeSchema extends Object { class CakeSchema extends Object {
/** /**
* Name of the schema * Name of the schema.
* *
* @var string * @var string
*/ */
public $name = null; public $name = null;
/** /**
* Path to write location * Path to write location.
* *
* @var string * @var string
*/ */
public $path = null; public $path = null;
/** /**
* File to write * File to write.
* *
* @var string * @var string
*/ */
public $file = 'schema.php'; public $file = 'schema.php';
/** /**
* Connection used for read * Connection used for read.
* *
* @var string * @var string
*/ */
public $connection = 'default'; public $connection = 'default';
/** /**
* plugin name. * Plugin name.
* *
* @var string * @var string
*/ */
public $plugin = null; public $plugin = null;
/** /**
* Set of tables * Set of tables.
* *
* @var array * @var array
*/ */
@ -73,7 +73,7 @@ class CakeSchema extends Object {
/** /**
* Constructor * Constructor
* *
* @param array $options optional load object properties * @param array $options Optional load object properties.
*/ */
public function __construct($options = array()) { public function __construct($options = array()) {
parent::__construct(); parent::__construct();
@ -98,9 +98,9 @@ class CakeSchema extends Object {
} }
/** /**
* Builds schema object properties * Builds schema object properties.
* *
* @param array $data loaded object properties * @param array $data Loaded object properties.
* @return void * @return void
*/ */
public function build($data) { public function build($data) {
@ -129,29 +129,29 @@ class CakeSchema extends Object {
} }
/** /**
* Before callback to be implemented in subclasses * Before callback to be implemented in subclasses.
* *
* @param array $event schema object properties * @param array $event Schema object properties.
* @return bool Should process continue * @return bool Should process continue.
*/ */
public function before($event = array()) { public function before($event = array()) {
return true; return true;
} }
/** /**
* After callback to be implemented in subclasses * After callback to be implemented in subclasses.
* *
* @param array $event schema object properties * @param array $event Schema object properties.
* @return void * @return void
*/ */
public function after($event = array()) { public function after($event = array()) {
} }
/** /**
* Reads database and creates schema tables * Reads database and creates schema tables.
* *
* @param array $options schema object properties * @param array $options Schema object properties.
* @return array Set of name and tables * @return array Set of name and tables.
*/ */
public function load($options = array()) { public function load($options = array()) {
if (is_string($options)) { if (is_string($options)) {
@ -178,7 +178,7 @@ class CakeSchema extends Object {
} }
/** /**
* Reads database and creates schema tables * Reads database and creates schema tables.
* *
* Options * Options
* *
@ -186,8 +186,8 @@ class CakeSchema extends Object {
* - 'name' - name of the schema * - 'name' - name of the schema
* - 'models' - a list of models to use, or false to ignore models * - 'models' - a list of models to use, or false to ignore models
* *
* @param array $options schema object properties * @param array $options Schema object properties.
* @return array Array indexed by name and tables * @return array Array indexed by name and tables.
*/ */
public function read($options = array()) { public function read($options = array()) {
extract(array_merge( extract(array_merge(
@ -340,11 +340,11 @@ class CakeSchema extends Object {
} }
/** /**
* Writes schema file from object or options * Writes schema file from object or options.
* *
* @param array|object $object schema object or options array * @param array|object $object Schema object or options array.
* @param array $options schema object properties to override object * @param array $options Schema object properties to override object.
* @return mixed false or string written to file * @return mixed False or string written to file.
*/ */
public function write($object, $options = array()) { public function write($object, $options = array()) {
if (is_object($object)) { if (is_object($object)) {
@ -398,11 +398,11 @@ class CakeSchema extends Object {
/** /**
* Generate the code for a table. Takes a table name and $fields array * Generate the code for a table. Takes a table name and $fields array
* Returns a completed variable declaration to be used in schema classes * Returns a completed variable declaration to be used in schema classes.
* *
* @param string $table Table name you want returned. * @param string $table Table name you want returned.
* @param array $fields Array of field information to generate the table with. * @param array $fields Array of field information to generate the table with.
* @return string Variable declaration for a schema class * @return string Variable declaration for a schema class.
*/ */
public function generateTable($table, $fields) { public function generateTable($table, $fields) {
$out = "\tpublic \${$table} = array(\n"; $out = "\tpublic \${$table} = array(\n";
@ -442,11 +442,11 @@ class CakeSchema extends Object {
} }
/** /**
* Compares two sets of schemas * Compares two sets of schemas.
* *
* @param array|object $old Schema object or array * @param array|object $old Schema object or array.
* @param array|object $new Schema object or array * @param array|object $new Schema object or array.
* @return array Tables (that are added, dropped, or changed) * @return array Tables (that are added, dropped, or changed.)
*/ */
public function compare($old, $new = null) { public function compare($old, $new = null) {
if (empty($new)) { if (empty($new)) {
@ -528,15 +528,15 @@ class CakeSchema extends Object {
} }
/** /**
* Extended array_diff_assoc noticing change from/to NULL values * Extended array_diff_assoc noticing change from/to NULL values.
* *
* It behaves almost the same way as array_diff_assoc except for NULL values: if * It behaves almost the same way as array_diff_assoc except for NULL values: if
* one of the values is not NULL - change is detected. It is useful in situation * one of the values is not NULL - change is detected. It is useful in situation
* where one value is strval('') ant other is strval(null) - in string comparing * where one value is strval('') ant other is strval(null) - in string comparing
* methods this results as EQUAL, while it is not. * methods this results as EQUAL, while it is not.
* *
* @param array $array1 Base array * @param array $array1 Base array.
* @param array $array2 Corresponding array checked for equality * @param array $array2 Corresponding array checked for equality.
* @return array Difference as array with array(keys => values) from input array * @return array Difference as array with array(keys => values) from input array
* where match was not found. * where match was not found.
*/ */
@ -568,10 +568,10 @@ class CakeSchema extends Object {
} }
/** /**
* Formats Schema columns from Model Object * Formats Schema columns from Model Object.
* *
* @param array $values options keys(type, null, default, key, length, extra) * @param array $values Options keys(type, null, default, key, length, extra).
* @return array Formatted values * @return array Formatted values.
*/ */
protected function _values($values) { protected function _values($values) {
$vals = array(); $vals = array();
@ -596,10 +596,10 @@ class CakeSchema extends Object {
} }
/** /**
* Formats Schema columns from Model Object * Formats Schema columns from Model Object.
* *
* @param array &$Obj model object * @param array &$Obj model object.
* @return array Formatted columns * @return array Formatted columns.
*/ */
protected function _columns(&$Obj) { protected function _columns(&$Obj) {
$db = $Obj->getDataSource(); $db = $Obj->getDataSource();
@ -639,10 +639,10 @@ class CakeSchema extends Object {
} }
/** /**
* Compare two schema files table Parameters * Compare two schema files table Parameters.
* *
* @param array $new New indexes * @param array $new New indexes.
* @param array $old Old indexes * @param array $old Old indexes.
* @return mixed False on failure, or an array of parameters to add & drop. * @return mixed False on failure, or an array of parameters to add & drop.
*/ */
protected function _compareTableParameters($new, $old) { protected function _compareTableParameters($new, $old) {
@ -654,11 +654,11 @@ class CakeSchema extends Object {
} }
/** /**
* Compare two schema indexes * Compare two schema indexes.
* *
* @param array $new New indexes * @param array $new New indexes.
* @param array $old Old indexes * @param array $old Old indexes.
* @return mixed false on failure or array of indexes to add and drop * @return mixed False on failure or array of indexes to add and drop.
*/ */
protected function _compareIndexes($new, $old) { protected function _compareIndexes($new, $old) {
if (!is_array($new) || !is_array($old)) { if (!is_array($new) || !is_array($old)) {
@ -705,22 +705,23 @@ class CakeSchema extends Object {
} }
/** /**
* Trim the table prefix from the full table name, and return the prefix-less table * Trim the table prefix from the full table name, and return the prefix-less
* table.
* *
* @param string $prefix Table prefix * @param string $prefix Table prefix.
* @param string $table Full table name * @param string $table Full table name.
* @return string Prefix-less table name * @return string Prefix-less table name.
*/ */
protected function _noPrefixTable($prefix, $table) { protected function _noPrefixTable($prefix, $table) {
return preg_replace('/^' . preg_quote($prefix) . '/', '', $table); return preg_replace('/^' . preg_quote($prefix) . '/', '', $table);
} }
/** /**
* Attempts to require the schema file specified * Attempts to require the schema file specified.
* *
* @param string $path Filesystem path to the file * @param string $path Filesystem path to the file.
* @param string $file Filesystem basename of the file * @param string $file Filesystem basename of the file.
* @return bool True when a file was successfully included, false on failure * @return bool True when a file was successfully included, false on failure.
*/ */
protected function _requireFile($path, $file) { protected function _requireFile($path, $file) {
if (file_exists($path . DS . $file) && is_file($path . DS . $file)) { if (file_exists($path . DS . $file) && is_file($path . DS . $file)) {