Skip to content
Snippets Groups Projects
Commit 0c2af95f authored by catch's avatar catch
Browse files

Issue #3437514 by kim.pepper, alexpott: Deprecate hook_file_validate() API docs

parent 557fe765
No related branches found
No related tags found
23 merge requests!11185Issue #3477324 by andypost, alexpott: Fix usage of str_getcsv() and fgetcsv() for PHP 8.4,!10602Issue #3438769 by vinmayiswamy, antonnavi, michelle, amateescu: Sub workspace does not clear,!10301Issue #3469309 by mstrelan, smustgrave, moshe weitzman: Use one-time login...,!10187Issue #3487488 by dakwamine: ExtensionMimeTypeGuesser::guessMimeType must support file names with "0" (zero) like foo.0.zip,!9944Issue #3483353: Consider making the createCopy config action optionally fail...,!9929Issue #3445469 by pooja_sharma, smustgrave: Add additional test coverage for...,!9787Resolve issue 3479427 - bootstrap barrio issue under Windows,!9742Issue #3463908 by catch, quietone: Split OptionsFieldUiTest into two,!9526Issue #3458177 by mondrake, catch, quietone, godotislate, longwave, larowlan,...,!8738Issue #3424162 by camilledavis, dineshkumarbollu, smustgrave: Claro...,!8704Make greek characters available in ckeditor5,!8597Draft: Issue #3442259 by catch, quietone, dww: Reduce time of Migrate Upgrade tests...,!8533Issue #3446962 by kim.pepper: Remove incorrectly added...,!8517Issue #3443748 by NexusNovaz, smustgrave: Testcase creates false positive,!8325Update file Sort.php,!8095Expose document root on install,!7930Resolve #3427374 "Taxonomytid viewsargumentdefault plugin",!7627Issue #3439440 by nicxvan, Binoli Lalani, longwave: Remove country support from DateFormatter,!7445Issue #3440169: When using drupalGet(), provide an associative array for $headers,!7384Add constraints to system.advisories,!6502Draft: Resolve #2938524 "Plach testing issue",!38582585169-10.1.x,!3226Issue #2987537: Custom menu link entity type should not declare "bundle" entity key
Pipeline #135307 passed with warnings
Stage: 🏗️ Build
Stage: 🪄 Lint
Stage: 🗜️ Test
Pipeline: drupal

#135316

    Hide whitespace changes
    Inline Side-by-side
    core/modules/file/file.api.php
    + 11
    − 6
    View file @ 0c2af95f
    ...@@ -15,7 +15,7 @@ ...@@ -15,7 +15,7 @@
    * Using \Drupal\file\Element\ManagedFile field with a defined list of allowed * Using \Drupal\file\Element\ManagedFile field with a defined list of allowed
    * extensions is best way to provide a file upload field. It will ensure that: * extensions is best way to provide a file upload field. It will ensure that:
    * - File names are sanitized by the FileUploadSanitizeNameEvent event. * - File names are sanitized by the FileUploadSanitizeNameEvent event.
    * - Files are validated by hook implementations of hook_file_validate(). * - Files are validated by \Drupal\file\Validation\FileValidatorInterface().
    * - Files with insecure extensions will be blocked by default even if they are * - Files with insecure extensions will be blocked by default even if they are
    * listed. If .txt is an allowed extension such files will be renamed. * listed. If .txt is an allowed extension such files will be renamed.
    * *
    ...@@ -27,14 +27,15 @@ ...@@ -27,14 +27,15 @@
    * '#type' => 'file', * '#type' => 'file',
    * '#title' => $this->t('Upload file'), * '#title' => $this->t('Upload file'),
    * '#upload_validators' => [ * '#upload_validators' => [
    * 'file_validate_extensions' => [ * 'FileExtension' => [
    * 'png gif jpg', * 'extensions' => 'png gif jpg',
    * ],
    * ], * ],
    * ], * ],
    * ]; * ];
    * @endcode * @endcode
    * - Use file_save_upload() to trigger the FileUploadSanitizeNameEvent event and * - Use file_save_upload() to trigger the FileUploadSanitizeNameEvent event and
    * hook_file_validate(). * \Drupal\file\Validation\FileValidatorInterface::validate().
    * *
    * Important considerations, regardless of the form element used: * Important considerations, regardless of the form element used:
    * - Always use and validate against a list of allowed extensions. * - Always use and validate against a list of allowed extensions.
    ...@@ -43,7 +44,7 @@ ...@@ -43,7 +44,7 @@
    * recommended. * recommended.
    * *
    * @see https://cheatsheetseries.owasp.org/cheatsheets/File_Upload_Cheat_Sheet.html * @see https://cheatsheetseries.owasp.org/cheatsheets/File_Upload_Cheat_Sheet.html
    * @see \hook_file_validate() * @see \Drupal\file\Validation\FileValidatorInterface
    * @see file_save_upload() * @see file_save_upload()
    * @see \Drupal\Core\File\Event\FileUploadSanitizeNameEvent * @see \Drupal\Core\File\Event\FileUploadSanitizeNameEvent
    * @see \Drupal\system\EventSubscriber\SecurityFileUploadEventSubscriber * @see \Drupal\system\EventSubscriber\SecurityFileUploadEventSubscriber
    ...@@ -71,7 +72,11 @@ ...@@ -71,7 +72,11 @@
    * An array of error messages. If there are no problems with the file return * An array of error messages. If there are no problems with the file return
    * an empty array. * an empty array.
    * *
    * @see file_validate() * @deprecated in drupal:10.2.0 and is removed from drupal:11.0.0. Use the
    * 'file.validator' service instead.
    *
    * @see https://www.drupal.org/node/3363700
    * @see \Drupal\file\Validation\FileValidatorInterface
    */ */
    function hook_file_validate(\Drupal\file\FileInterface $file) { function hook_file_validate(\Drupal\file\FileInterface $file) {
    $errors = []; $errors = [];
    ......
    0% or .
    You are about to add 0 people to the discussion. Proceed with caution.
    Finish editing this message first!
    Please register or to comment