Merge pull request #264 from raicabogdan/5.9.x

Update documentation links and add a warning for relation delete() callback

Author: niden

docs/autoload.md

@@ -746,3 +746,4 @@ Unregister the autoload method
 [loader]: api/phalcon_autoload.md#autoloadloader
 [loader-exception]: api/phalcon_autoload.md#autoloadexception
 [eventsawareinterface]: api/phalcon_events.md#eventseventsawareinterface
+[events]: api/phalcon_events.md#eventsmanager

docs/config.md

@@ -870,3 +870,4 @@ Also in views (Volt syntax)
 [parse-ini-file]: https://www.php.net/manual/en/function.parse-ini-file.php
 [yaml-parse-file]: https://www.php.net/manual/en/function.yaml-parse-file.php
 [di]: di.md
+[support-collection]: support-collection.md

docs/controllers.md

@@ -625,3 +625,5 @@ $container->set(
 [events]: events.md
 [application]: application.md
 [autoload]: autoload.md
+[routing]: routing.md
+[views]: views.md

docs/db-models-relationships.md

@@ -1398,6 +1398,19 @@ $customer->getInvoices()->delete();
 
 `delete()` also accepts an anonymous function to filter what records must be deleted:
 
+!!! warning "NOTE"
+
+    `delete()` only works safely with `hasMany()` relationships. The deletion callback runs before the actual deletion of the parent model.
+    
+    This makes it safe for:
+    
+    - Deleting child models that hold a foreign key to the parent (e.g., hasMany)
+    
+    But unsafe for:
+    
+    - Deleting related models that the parent depends on via a foreign key (e.g., belongsTo or hasOne where FK is in parent)
+
+
 ```php
 <?php
 

docs/di.md

@@ -1604,6 +1604,7 @@ The [Phalcon\Di\DiInterface][di-diinterface] interface must be implemented to cr
 [annotations]: annotations.md
 [ssets]: ssets.md
 [encryption-crypt]: encryption-crypt.md
+[assets]: assets.md
 [response-cookies]: response.md#cookies
 [dispatcher]: dispatcher.md
 [html-escaper]: html-escaper.md
@@ -1621,4 +1622,5 @@ The [Phalcon\Di\DiInterface][di-diinterface] interface must be implemented to cr
 [db-models-transactions]: db-models-transactions.md
 [mvc-url]: mvc-url.md
 [db-layer]: db-layer.md
-[session#bag]: session.md#bag
+[session-bag]: session.md#bag
+[singletons]: https://en.wikipedia.org/wiki/Singleton_pattern

docs/encryption-crypt.md

@@ -161,7 +161,7 @@ The `encryptBase64()` can be used to encrypt a string in a URL-friendly way. It
 The `decryptBase64()` can be used to decrypt a string in a URL-friendly way. Similar to `encryptBase64()` it uses `decrypt()` internally and accepts the `text` and optionally the `key` of the element to encrypt. There is also a third parameter `safe` (defaults to `false`) which will perform string replacements for previously replaced non URL _friendly_  characters such as `+` or `/`.
 
 ## Exceptions
-Exceptions thrown in the [Phalcon\Encryption\Crypt][crypt] component will be of type [Phalcon\Encryption\Crypt\Exception][config-exception]. If however, you are using signing and the calculated hash for `decrypt()` does not match, [Phalcon\Encryption\Crypt\Mismatch][crypt-mismatch] will be thrown. You can use these exceptions to selectively catch exceptions thrown only from this component.
+Exceptions thrown in the [Phalcon\Encryption\Crypt][crypt] component will be of type [Phalcon\Encryption\Crypt\Exception][crypt-exception]. If however, you are using signing and the calculated hash for `decrypt()` does not match, [Phalcon\Encryption\Crypt\Mismatch][crypt-mismatch] will be thrown. You can use these exceptions to selectively catch exceptions thrown only from this component.
 
 ```php
 <?php
@@ -190,7 +190,7 @@ The getter `getCipher()` returns the currently selected cipher. If none has been
 You can always get an array of all the available ciphers for your system by calling  `getAvailableCiphers()`.
 
 ### Hash Algorithm
-The getter `getHashAlgo()` returns the hashing algorithm used by the component. If none has been explicitly defined by the setter `setHashAlgo()` the `sha256` will be used. If the hash algorithm defined is not available in the system or is wrong, a [Phalcon\Encryption\Crypt\Exception][crypt=exception] will be thrown.
+The getter `getHashAlgo()` returns the hashing algorithm used by the component. If none has been explicitly defined by the setter `setHashAlgo()` the `sha256` will be used. If the hash algorithm defined is not available in the system or is wrong, a [Phalcon\Encryption\Crypt\Exception][crypt-exception] will be thrown.
 
 You can always get an array of all the available hashing algorithms for your system by calling  `getAvailableHashAlgos()`.
 

docs/encryption-security-jwt.md

@@ -222,7 +222,7 @@ $signer  = new Hmac('sha256');
 $signer  = new Hmac('sha111'); // exception
 ```
 
-The component utilizes the [hmac_equals][hmac_equals] and [hash_hmac][hash_hmac] PHP methods internally to verify and sign the payload. It exposes the following methods:
+The component utilizes the [hash_equals][hash-equals] and [hash_hmac][hash-hmac] PHP methods internally to verify and sign the payload. It exposes the following methods:
 
 ```php
 public function getAlgHeader(): string

docs/events.md

@@ -965,6 +965,7 @@ The events available in Phalcon are:
 
 [db]: api/phalcon_db.md
 [di-factorydefaul]: api/phalcon_di.md#difactorydefault
+[di-injectable]: api/phalcon_di.md#diinjectable
 [events-event]: api/phalcon_events.md#eventsevent
 [events-eventinterface]: api/phalcon_events.md#eventseventinterface
 [events-eventsawareinterface]: api/phalcon_events.md#eventseventsawareinterface

docs/filter-filter.md

@@ -575,6 +575,7 @@ $filteredIp = $locator->sanitize('127.0.0.1', 'ipv4');
 [absint]: https://www.php.net/manual/en/function.absint.php
 [filter]: https://www.php.net/manual/en/book.filter.php
 [filter_var]: https://www.php.net/manual/en/function.filter-var.php
+[htmlspecialchars]: https://www.php.net/manual/en/function.htmlspecialchars.php
 [intval]: https://www.php.net/manual/en/function.intval.php
 [invoke]: https://www.php.net/manual/en/language.oop5.magic.php#object.invoke
 [lcfirst]: https://www.php.net/manual/en/function.lcfirst.php

docs/flash.md

@@ -579,3 +579,4 @@ class InvoicesController extends Controller
 [flash-session]: api/phalcon_flash.md#flashsession
 [di-injectable]: api/phalcon_di.md#diinjectable
 [factorydefault]: api/phalcon_di.md#difactorydefault
+[bootstrap]: https://getbootstrap.com/