@@ -243,7 +243,7 @@ discard block |
||
| 243 | 243 | /** |
| 244 | 244 | * Get the year part. |
| 245 | 245 | * |
| 246 | - * @return int |
|
| 246 | + * @return string |
|
| 247 | 247 | * |
| 248 | 248 | * @since 1.0 |
| 249 | 249 | */ |
@@ -255,7 +255,7 @@ discard block |
||
| 255 | 255 | /** |
| 256 | 256 | * Get the month part. |
| 257 | 257 | * |
| 258 | - * @return int |
|
| 258 | + * @return string |
|
| 259 | 259 | * |
| 260 | 260 | * @since 1.0 |
| 261 | 261 | */ |
@@ -267,7 +267,7 @@ discard block |
||
| 267 | 267 | /** |
| 268 | 268 | * Get the day part. |
| 269 | 269 | * |
| 270 | - * @return int |
|
| 270 | + * @return string |
|
| 271 | 271 | * |
| 272 | 272 | * @since 1.0 |
| 273 | 273 | */ |
@@ -6,7 +6,6 @@ |
||
| 6 | 6 | use Alpha\Model\Type\Integer; |
| 7 | 7 | use Alpha\Model\Type\Timestamp; |
| 8 | 8 | use Alpha\Model\Type\TypeInterface; |
| 9 | -use Alpha\Model\Type\Enum; |
|
| 10 | 9 | use Alpha\Model\Type\Relation; |
| 11 | 10 | use Alpha\Util\Config\ConfigProvider; |
| 12 | 11 | use Alpha\Util\Logging\Logger; |
@@ -1156,7 +1156,7 @@ discard block |
||
| 1156 | 1156 | /** |
| 1157 | 1157 | * Gets the ID for the object in zero-padded format (same as getID()). |
| 1158 | 1158 | * |
| 1159 | - * @return int 11 digit zero-padded ID value. |
|
| 1159 | + * @return string 11 digit zero-padded ID value. |
|
| 1160 | 1160 | * |
| 1161 | 1161 | * @since 1.0 |
| 1162 | 1162 | */ |
@@ -2153,7 +2153,7 @@ discard block |
||
| 2153 | 2153 | /** |
| 2154 | 2154 | * Starts a new database transaction. |
| 2155 | 2155 | * |
| 2156 | - * @param $Record The ActiveRecord instance to pass to the database provider. Leave empty to have a new Person passed. |
|
| 2156 | + * @param ActiveRecord $Record The ActiveRecord instance to pass to the database provider. Leave empty to have a new Person passed. |
|
| 2157 | 2157 | * |
| 2158 | 2158 | * @since 1.0 |
| 2159 | 2159 | * |
@@ -2186,7 +2186,7 @@ discard block |
||
| 2186 | 2186 | /** |
| 2187 | 2187 | * Commits the current database transaction. |
| 2188 | 2188 | * |
| 2189 | - * @param $Record The ActiveRecord instance to pass to the database provider. Leave empty to have a new Person passed. |
|
| 2189 | + * @param ActiveRecord $Record The ActiveRecord instance to pass to the database provider. Leave empty to have a new Person passed. |
|
| 2190 | 2190 | * |
| 2191 | 2191 | * @since 1.0 |
| 2192 | 2192 | * |
@@ -2219,7 +2219,7 @@ discard block |
||
| 2219 | 2219 | /** |
| 2220 | 2220 | * Aborts the current database transaction. |
| 2221 | 2221 | * |
| 2222 | - * @param $Record The ActiveRecord instance to pass to the database provider. Leave empty to have a new Person passed. |
|
| 2222 | + * @param ActiveRecord $Record The ActiveRecord instance to pass to the database provider. Leave empty to have a new Person passed. |
|
| 2223 | 2223 | * |
| 2224 | 2224 | * @since 1.0 |
| 2225 | 2225 | * |
@@ -2390,7 +2390,7 @@ discard block |
||
| 2390 | 2390 | /** |
| 2391 | 2391 | * Check to see if an attribute exists on the record. |
| 2392 | 2392 | * |
| 2393 | - * @param $attribute The attribute name. |
|
| 2393 | + * @param string $attribute The attribute name. |
|
| 2394 | 2394 | * |
| 2395 | 2395 | * @return bool |
| 2396 | 2396 | * |
@@ -541,7 +541,7 @@ discard block |
||
| 541 | 541 | * @param string $sourceDir The path to the source directory. |
| 542 | 542 | * @param string $fileList The HTML list of files generated (pass by reference). |
| 543 | 543 | * @param int $fileCount The current file count (used in recursive calls). |
| 544 | - * @param array $excludeFiles An array of file names to exclude from the list rendered. |
|
| 544 | + * @param string[] $excludeFiles An array of file names to exclude from the list rendered. |
|
| 545 | 545 | * |
| 546 | 546 | * @return int The current filecount for the directory. |
| 547 | 547 | * |
@@ -578,7 +578,7 @@ discard block |
||
| 578 | 578 | * Recursively deletes the contents of the directory indicated (the directory itself is not deleted). |
| 579 | 579 | * |
| 580 | 580 | * @param string $sourceDir The path to the source directory. |
| 581 | - * @param array $excludeFiles An array of file names to exclude from the deletion. |
|
| 581 | + * @param string[] $excludeFiles An array of file names to exclude from the deletion. |
|
| 582 | 582 | * |
| 583 | 583 | * @throws \Alpha\Exception\AlphaException |
| 584 | 584 | * |
@@ -234,16 +234,16 @@ discard block |
||
| 234 | 234 | self::$logger->debug('<<__construct()'); |
| 235 | 235 | } |
| 236 | 236 | |
| 237 | - /** |
|
| 238 | - * Facade method which will invoke our custom markdown class rather than the standard one. |
|
| 239 | - * |
|
| 240 | - * @param $text The markdown content to parse |
|
| 241 | - * |
|
| 242 | - * @since 1.0 |
|
| 243 | - */ |
|
| 244 | - private function markdown($text) |
|
| 245 | - { |
|
| 246 | - $config = ConfigProvider::getInstance(); |
|
| 237 | + /** |
|
| 238 | + * Facade method which will invoke our custom markdown class rather than the standard one. |
|
| 239 | + * |
|
| 240 | + * @param $text The markdown content to parse |
|
| 241 | + * |
|
| 242 | + * @since 1.0 |
|
| 243 | + */ |
|
| 244 | + private function markdown($text) |
|
| 245 | + { |
|
| 246 | + $config = ConfigProvider::getInstance(); |
|
| 247 | 247 | |
| 248 | 248 | /* |
| 249 | 249 | * Initialize the parser and return the result of its transform method. |
@@ -251,9 +251,9 @@ discard block |
||
| 251 | 251 | */ |
| 252 | 252 | static $parser; |
| 253 | 253 | |
| 254 | - if (!isset($parser)) { |
|
| 255 | - $parser = new Markdown(); |
|
| 256 | - } |
|
| 254 | + if (!isset($parser)) { |
|
| 255 | + $parser = new Markdown(); |
|
| 256 | + } |
|
| 257 | 257 | |
| 258 | 258 | /* |
| 259 | 259 | * Replace all instances of $sysURL in the text with the app.url setting from config |
@@ -263,7 +263,7 @@ discard block |
||
| 263 | 263 | |
| 264 | 264 | // transform text using parser. |
| 265 | 265 | return $parser->transform($text); |
| 266 | - } |
|
| 266 | + } |
|
| 267 | 267 | |
| 268 | 268 | /** |
| 269 | 269 | * Fetter for the content. |
@@ -284,7 +284,7 @@ discard block |
||
| 284 | 284 | /** |
| 285 | 285 | * Get the node offset. |
| 286 | 286 | * |
| 287 | - * @return string |
|
| 287 | + * @return integer |
|
| 288 | 288 | * |
| 289 | 289 | * @since 1.0 |
| 290 | 290 | */ |
@@ -460,7 +460,7 @@ discard block |
||
| 460 | 460 | /** |
| 461 | 461 | * Calculates and returns the midpoint X coordinate of the children of this node. |
| 462 | 462 | * |
| 463 | - * @return int |
|
| 463 | + * @return double |
|
| 464 | 464 | * |
| 465 | 465 | * @since 1.0 |
| 466 | 466 | */ |
@@ -487,7 +487,7 @@ discard block |
||
| 487 | 487 | /** |
| 488 | 488 | * Add a new node to the children array of this node. |
| 489 | 489 | * |
| 490 | - * @param Alpha\Util\Graph\GraphNode $node |
|
| 490 | + * @param GraphNode $node |
|
| 491 | 491 | * |
| 492 | 492 | * @throws ALpha\Exception\IllegalArguementException |
| 493 | 493 | * |
@@ -67,7 +67,7 @@ |
||
| 67 | 67 | * A static method that attempts to return a ActiveRecordProviderInterface instance |
| 68 | 68 | * based on the name of the provider class supplied. |
| 69 | 69 | * |
| 70 | - * @param $providerName The fully-qualified class name of the provider class. |
|
| 70 | + * @param string $providerName The fully-qualified class name of the provider class. |
|
| 71 | 71 | * @param $Record The (optional) active record instance to pass to the persistance provider for mapping. |
| 72 | 72 | * |
| 73 | 73 | * @throws \Alpha\Exception\IllegalArguementException |
@@ -2340,11 +2340,11 @@ |
||
| 2340 | 2340 | * parameters. If arrays of attribute names and values are provided, only those will be bound to |
| 2341 | 2341 | * the supplied statement. |
| 2342 | 2342 | * |
| 2343 | - * @param mysqli_stmt $stmt The SQL statement to bind to. |
|
| 2343 | + * @param \mysqli_stmt $stmt The SQL statement to bind to. |
|
| 2344 | 2344 | * @param array Optional array of Record attributes. |
| 2345 | 2345 | * @param array Optional array of Record values. |
| 2346 | 2346 | * |
| 2347 | - * @return mysqli_stmt |
|
| 2347 | + * @return \mysqli_stmt |
|
| 2348 | 2348 | * |
| 2349 | 2349 | * @since 1.1 |
| 2350 | 2350 | */ |
@@ -508,7 +508,7 @@ discard block |
||
| 508 | 508 | /** |
| 509 | 509 | * Getter for the Relation value. |
| 510 | 510 | * |
| 511 | - * @return mixed |
|
| 511 | + * @return string |
|
| 512 | 512 | * |
| 513 | 513 | * @since 1.0 |
| 514 | 514 | */ |
@@ -748,7 +748,7 @@ discard block |
||
| 748 | 748 | * Set the taggedClass property to the name of the tagged class when building relations |
| 749 | 749 | * to the TagObject record. |
| 750 | 750 | * |
| 751 | - * @param $taggedClass |
|
| 751 | + * @param string $taggedClass |
|
| 752 | 752 | * |
| 753 | 753 | * @since 1.0 |
| 754 | 754 | */ |
@@ -60,6 +60,7 @@ discard block |
||
| 60 | 60 | * Disconnects the current database connection if one exists (self::$connection is set). |
| 61 | 61 | * |
| 62 | 62 | * @since 1.1 |
| 63 | + * @return void |
|
| 63 | 64 | */ |
| 64 | 65 | public static function disconnect(); |
| 65 | 66 | |
@@ -81,6 +82,7 @@ discard block |
||
| 81 | 82 | * @since 1.1 |
| 82 | 83 | * |
| 83 | 84 | * @throws \Alpha\Exception\RecordFoundException |
| 85 | + * @return void |
|
| 84 | 86 | */ |
| 85 | 87 | public function load($ID, $version = 0); |
| 86 | 88 | |
@@ -100,7 +102,7 @@ discard block |
||
| 100 | 102 | /** |
| 101 | 103 | * Populates the record object from the database table by the given attribute value. |
| 102 | 104 | * |
| 103 | - * @param string $atribute The name of the attribute to load the record by. |
|
| 105 | + * @param string $attribute The name of the attribute to load the record by. |
|
| 104 | 106 | * @param string $value The value of the attribute to load the record by. |
| 105 | 107 | * @param bool $ignoreClassType Default is false, set to true if you want to load from overloaded tables and ignore the class type |
| 106 | 108 | * @param array $loadAttributes The attributes to load from the database to this object (leave blank to load all attributes) |
@@ -108,6 +110,7 @@ discard block |
||
| 108 | 110 | * @since 1.1 |
| 109 | 111 | * |
| 110 | 112 | * @throws \Alpha\Exception\RecordFoundException |
| 113 | + * @return void |
|
| 111 | 114 | */ |
| 112 | 115 | public function loadByAttribute($attribute, $value, $ignoreClassType = false, $loadAttributes = array()); |
| 113 | 116 | |
@@ -131,14 +134,14 @@ discard block |
||
| 131 | 134 | /** |
| 132 | 135 | * Loads all of the objects of this class by the specified attribute into an array which is returned. |
| 133 | 136 | * |
| 134 | - * @param string $atribute The attribute to load the objects by. |
|
| 137 | + * @param string $attribute The attribute to load the objects by. |
|
| 135 | 138 | * @param string $value The value of the attribute to load the objects by. |
| 136 | 139 | * @param int $start The start of the SQL LIMIT clause, useful for pagination. |
| 137 | 140 | * @param int $limit The amount (limit) of objects to load, useful for pagination. |
| 138 | 141 | * @param string $orderBy The name of the field to sort the objects by. |
| 139 | 142 | * @param string $order The order to sort the objects by. |
| 140 | 143 | * @param bool $ignoreClassType Default is false, set to true if you want to load from overloaded tables and ignore the class type. |
| 141 | - * @param array $constructorArgs An optional array of contructor arguements to pass to the records that will be generated and returned. Supports a maximum of 5 arguements. |
|
| 144 | + * @param string[] $constructorArgs An optional array of contructor arguements to pass to the records that will be generated and returned. Supports a maximum of 5 arguements. |
|
| 142 | 145 | * |
| 143 | 146 | * @return array An array containing objects of this type of business object. |
| 144 | 147 | * |
@@ -152,14 +155,14 @@ discard block |
||
| 152 | 155 | /** |
| 153 | 156 | * Loads all of the record objects of this class by the specified attributes into an array which is returned. |
| 154 | 157 | * |
| 155 | - * @param array $atributes The attributes to load the records by. |
|
| 158 | + * @param array $attributes The attributes to load the records by. |
|
| 156 | 159 | * @param array $values The values of the attributes to load the records by. |
| 157 | 160 | * @param int $start The start of the SQL LIMIT clause, useful for pagination. |
| 158 | 161 | * @param int $limit The amount (limit) of records to load, useful for pagination. |
| 159 | 162 | * @param string $orderBy The name of the field to sort the records by. |
| 160 | 163 | * @param string $order The order to sort the records by. |
| 161 | 164 | * @param bool $ignoreClassType Default is false, set to true if you want to load from overloaded tables and ignore the class type |
| 162 | - * @param array $constructorArgs An optional array of contructor arguements to pass to the records that will be generated and returned. Supports a maximum of 5 arguements. |
|
| 165 | + * @param string[] $constructorArgs An optional array of contructor arguements to pass to the records that will be generated and returned. Supports a maximum of 5 arguements. |
|
| 163 | 166 | * |
| 164 | 167 | * @return array An array containing objects of this type of record object. |
| 165 | 168 | * |
@@ -214,6 +217,7 @@ discard block |
||
| 214 | 217 | * @throws \Alpha\Exception\FailedSaveException |
| 215 | 218 | * @throws \Alpha\Exception\LockingException |
| 216 | 219 | * @throws \Alpha\Exception\ValidationException |
| 220 | + * @return void |
|
| 217 | 221 | */ |
| 218 | 222 | public function save(); |
| 219 | 223 | |
@@ -229,6 +233,7 @@ discard block |
||
| 229 | 233 | * @throws \Alpha\Exception\IllegalArguementException |
| 230 | 234 | * @throws \Alpha\Exception\FailedSaveException |
| 231 | 235 | * @throws \Alpha\Exception\LockingException |
| 236 | + * @return void |
|
| 232 | 237 | */ |
| 233 | 238 | public function saveAttribute($attribute, $value); |
| 234 | 239 | |
@@ -238,6 +243,7 @@ discard block |
||
| 238 | 243 | * @since 1.2 |
| 239 | 244 | * |
| 240 | 245 | * @throws \Alpha\Exception\FailedSaveException |
| 246 | + * @return void |
|
| 241 | 247 | */ |
| 242 | 248 | public function saveHistory(); |
| 243 | 249 | |
@@ -247,6 +253,7 @@ discard block |
||
| 247 | 253 | * @since 1.1 |
| 248 | 254 | * |
| 249 | 255 | * @throws \Alpha\Exception\FailedDeleteException |
| 256 | + * @return void |
|
| 250 | 257 | */ |
| 251 | 258 | public function delete(); |
| 252 | 259 | |
@@ -267,6 +274,7 @@ discard block |
||
| 267 | 274 | * @since 1.1 |
| 268 | 275 | * |
| 269 | 276 | * @throws \Alpha\Exception\AlphaException |
| 277 | + * @return void |
|
| 270 | 278 | */ |
| 271 | 279 | public function makeTable(); |
| 272 | 280 | |
@@ -276,6 +284,7 @@ discard block |
||
| 276 | 284 | * @since 1.2 |
| 277 | 285 | * |
| 278 | 286 | * @throws \AlphaException |
| 287 | + * @return void |
|
| 279 | 288 | */ |
| 280 | 289 | public function makeHistoryTable(); |
| 281 | 290 | |
@@ -285,6 +294,7 @@ discard block |
||
| 285 | 294 | * @since 1.1 |
| 286 | 295 | * |
| 287 | 296 | * @throws \Alpha\Exception\AlphaException |
| 297 | + * @return void |
|
| 288 | 298 | */ |
| 289 | 299 | public function rebuildTable(); |
| 290 | 300 | |
@@ -296,6 +306,7 @@ discard block |
||
| 296 | 306 | * @param string $tableName Optional table name, leave blank for the defined table for this class to be dropped |
| 297 | 307 | * |
| 298 | 308 | * @throws \Alpha\Exception\AlphaException |
| 309 | + * @return void |
|
| 299 | 310 | */ |
| 300 | 311 | public function dropTable($tableName = null); |
| 301 | 312 | |
@@ -308,6 +319,7 @@ discard block |
||
| 308 | 319 | * @since 1.1 |
| 309 | 320 | * |
| 310 | 321 | * @throws \Alpha\Exception\AlphaException |
| 322 | + * @return void |
|
| 311 | 323 | */ |
| 312 | 324 | public function addProperty($propName); |
| 313 | 325 | |
@@ -325,7 +337,7 @@ discard block |
||
| 325 | 337 | /** |
| 326 | 338 | * Gets the count from the database for the amount of objects of this class. |
| 327 | 339 | * |
| 328 | - * @param array $atributes The attributes to count the objects by (optional). |
|
| 340 | + * @param array $attributes The attributes to count the objects by (optional). |
|
| 329 | 341 | * @param array $values The values of the attributes to count the objects by (optional). |
| 330 | 342 | * |
| 331 | 343 | * @return int |
@@ -354,6 +366,7 @@ discard block |
||
| 354 | 366 | * @since 1.1 |
| 355 | 367 | * |
| 356 | 368 | * @throws \Alpha\Exception\AlphaException |
| 369 | + * @return void |
|
| 357 | 370 | */ |
| 358 | 371 | public function setEnumOptions(); |
| 359 | 372 | |
@@ -427,12 +440,12 @@ discard block |
||
| 427 | 440 | * @param string $attributeName The name of the attribute to apply the index on. |
| 428 | 441 | * @param string $relatedClass The fully-qualified name of the related class. |
| 429 | 442 | * @param string $relatedClassAttribute The name of the field to relate to on the related class. |
| 430 | - * @param bool $allowNullValues For foreign key indexes that don't allow null values, set this to false (default is true). |
|
| 431 | 443 | * @param string $indexName The optional name for the index, will calculate if not provided. |
| 432 | 444 | * |
| 433 | 445 | * @since 1.1 |
| 434 | 446 | * |
| 435 | 447 | * @throws \Alpha\Exception\FailedIndexCreateException |
| 448 | + * @return void |
|
| 436 | 449 | */ |
| 437 | 450 | public function createForeignIndex($attributeName, $relatedClass, $relatedClassAttribute, $indexName = null); |
| 438 | 451 | |
@@ -446,6 +459,7 @@ discard block |
||
| 446 | 459 | * @since 1.1 |
| 447 | 460 | * |
| 448 | 461 | * @throws \Alpha\Exception\FailedIndexCreateException |
| 462 | + * @return void |
|
| 449 | 463 | */ |
| 450 | 464 | public function createUniqueIndex($attribute1Name, $attribute2Name = '', $attribute3Name = ''); |
| 451 | 465 | |
@@ -455,6 +469,7 @@ discard block |
||
| 455 | 469 | * @since 1.1 |
| 456 | 470 | * |
| 457 | 471 | * @throws \Alpha\Exception\AlphaException |
| 472 | + * @return void |
|
| 458 | 473 | */ |
| 459 | 474 | public function reload(); |
| 460 | 475 | |
@@ -490,6 +505,7 @@ discard block |
||
| 490 | 505 | * @since 1.1 |
| 491 | 506 | * |
| 492 | 507 | * @throws \Alpha\Exception\AlphaException |
| 508 | + * @return void |
|
| 493 | 509 | */ |
| 494 | 510 | public static function begin(); |
| 495 | 511 | |
@@ -499,6 +515,7 @@ discard block |
||
| 499 | 515 | * @since 1.1 |
| 500 | 516 | * |
| 501 | 517 | * @throws \Alpha\Exception\FailedSaveException |
| 518 | + * @return void |
|
| 502 | 519 | */ |
| 503 | 520 | public static function commit(); |
| 504 | 521 | |
@@ -508,6 +525,7 @@ discard block |
||
| 508 | 525 | * @since 1.1 |
| 509 | 526 | * |
| 510 | 527 | * @throws \Alpha\Exception\AlphaException |
| 528 | + * @return void |
|
| 511 | 529 | */ |
| 512 | 530 | public static function rollback(); |
| 513 | 531 | |
@@ -517,6 +535,7 @@ discard block |
||
| 517 | 535 | * @param \Alpha\Model\ActiveRecord $Record |
| 518 | 536 | * |
| 519 | 537 | * @since 1.1 |
| 538 | + * @return void |
|
| 520 | 539 | */ |
| 521 | 540 | public function setRecord($Record); |
| 522 | 541 | |
@@ -549,6 +568,7 @@ discard block |
||
| 549 | 568 | * @throws \Alpha\Exception\AlphaException |
| 550 | 569 | * |
| 551 | 570 | * @since 2.0 |
| 571 | + * @return void |
|
| 552 | 572 | */ |
| 553 | 573 | public static function createDatabase(); |
| 554 | 574 | |
@@ -558,6 +578,7 @@ discard block |
||
| 558 | 578 | * @throws \Alpha\Exception\AlphaException |
| 559 | 579 | * |
| 560 | 580 | * @since 2.0 |
| 581 | + * @return void |
|
| 561 | 582 | */ |
| 562 | 583 | public static function dropDatabase(); |
| 563 | 584 | } |