Skip to content

Commit 5eb4a07

Browse files
authored
Fix broken nocontentsentry placeholders in errors.md (#8202)
The RST-to-Markdown conversion dropped the `.. php:exception::` directive lines and left only the `:nocontentsentry:` option as literal text. Replace each occurrence with the fully qualified exception class name formatted as a definition list.
1 parent 879a8fc commit 5eb4a07

File tree

1 file changed

+102
-136
lines changed

1 file changed

+102
-136
lines changed

docs/en/development/errors.md

Lines changed: 102 additions & 136 deletions
Original file line numberDiff line numberDiff line change
@@ -405,55 +405,43 @@ dealt with by ErrorTrap by setting the `log` option to `true` in your
405405
Besides the internal framework exceptions, CakePHP provides several
406406
built-in exceptions for HTTP methods
407407

408-
> nocontentsentry
409-
>
410-
> > Used for doing 400 Bad Request error.
411-
>
412-
> nocontentsentry
413-
>
414-
> > Used for doing a 401 Unauthorized error.
415-
>
416-
> nocontentsentry
417-
>
418-
> > Used for doing a 403 Forbidden error.
419-
>
420-
> nocontentsentry
421-
>
422-
> > Used for doing a 403 error caused by an invalid CSRF token.
423-
>
424-
> nocontentsentry
425-
>
426-
> > Used for doing a 404 Not found error.
427-
>
428-
> nocontentsentry
429-
>
430-
> > Used for doing a 405 Method Not Allowed error.
431-
>
432-
> nocontentsentry
433-
>
434-
> > Used for doing a 406 Not Acceptable error.
435-
>
436-
> nocontentsentry
437-
>
438-
> > Used for doing a 409 Conflict error.
439-
>
440-
> nocontentsentry
441-
>
442-
> > Used for doing a 410 Gone error.
408+
`Cake\Http\Exception\BadRequestException`
409+
: Used for doing 400 Bad Request error.
410+
411+
`Cake\Http\Exception\UnauthorizedException`
412+
: Used for doing a 401 Unauthorized error.
413+
414+
`Cake\Http\Exception\ForbiddenException`
415+
: Used for doing a 403 Forbidden error.
416+
417+
`Cake\Http\Exception\InvalidCsrfTokenException`
418+
: Used for doing a 403 error caused by an invalid CSRF token.
419+
420+
`Cake\Http\Exception\NotFoundException`
421+
: Used for doing a 404 Not found error.
422+
423+
`Cake\Http\Exception\MethodNotAllowedException`
424+
: Used for doing a 405 Method Not Allowed error.
425+
426+
`Cake\Http\Exception\NotAcceptableException`
427+
: Used for doing a 406 Not Acceptable error.
428+
429+
`Cake\Http\Exception\ConflictException`
430+
: Used for doing a 409 Conflict error.
431+
432+
`Cake\Http\Exception\GoneException`
433+
: Used for doing a 410 Gone error.
443434

444435
For more details on HTTP 4xx error status codes see `2616#section-10.4`.
445436

446-
> nocontentsentry
447-
>
448-
> > Used for doing a 500 Internal Server Error.
449-
>
450-
> nocontentsentry
451-
>
452-
> > Used for doing a 501 Not Implemented Errors.
453-
>
454-
> nocontentsentry
455-
>
456-
> > Used for doing a 503 Service Unavailable error.
437+
`Cake\Http\Exception\InternalErrorException`
438+
: Used for doing a 500 Internal Server Error.
439+
440+
`Cake\Http\Exception\NotImplementedException`
441+
: Used for doing a 501 Not Implemented Errors.
442+
443+
`Cake\Http\Exception\ServiceUnavailableException`
444+
: Used for doing a 503 Service Unavailable error.
457445

458446
For more details on HTTP 5xx error status codes see `2616#section-10.5`.
459447

@@ -505,96 +493,74 @@ page, and log the exception.
505493

506494
In addition, CakePHP uses the following exceptions:
507495

508-
> nocontentsentry
509-
>
510-
> > The chosen view class could not be found.
511-
>
512-
> nocontentsentry
513-
>
514-
> > The chosen template file could not be found.
515-
>
516-
> nocontentsentry
517-
>
518-
> > The chosen layout could not be found.
519-
>
520-
> nocontentsentry
521-
>
522-
> > The chosen helper could not be found.
523-
>
524-
> nocontentsentry
525-
>
526-
> > The chosen element file could not be found.
527-
>
528-
> nocontentsentry
529-
>
530-
> > The chosen cell class could not be found.
531-
>
532-
> nocontentsentry
533-
>
534-
> > The chosen cell view file could not be found.
535-
>
536-
> nocontentsentry
537-
>
538-
> > A configured component could not be found.
539-
>
540-
> nocontentsentry
541-
>
542-
> > The requested controller action could not be found.
543-
>
544-
> nocontentsentry
545-
>
546-
> > Accessing private/protected/\_ prefixed actions.
547-
>
548-
> nocontentsentry
549-
>
550-
> > A console library class encounter an error.
551-
>
552-
> nocontentsentry
553-
>
554-
> > A model's connection is missing.
555-
>
556-
> nocontentsentry
557-
>
558-
> > A database driver could not be found.
559-
>
560-
> nocontentsentry
561-
>
562-
> > A PHP extension is missing for the database driver.
563-
>
564-
> nocontentsentry
565-
>
566-
> > A model's table could not be found.
567-
>
568-
> nocontentsentry
569-
>
570-
> > A model's entity could not be found.
571-
>
572-
> nocontentsentry
573-
>
574-
> > A model's behavior could not be found.
575-
>
576-
> nocontentsentry
577-
>
578-
> > An entity couldn't be saved/deleted while using `Cake\ORM\Table::saveOrFail()` or
579-
> > `Cake\ORM\Table::deleteOrFail()`.
580-
>
581-
> nocontentsentry
582-
>
583-
> The requested record could not be found. This will also set HTTP response
584-
> headers to 404.
585-
>
586-
> nocontentsentry
587-
>
588-
> > The requested controller could not be found.
589-
>
590-
> nocontentsentry
591-
>
592-
> > The requested URL cannot be reverse routed or cannot be parsed.
593-
>
594-
> nocontentsentry
595-
>
596-
> > Base exception class in CakePHP. All framework layer exceptions thrown by
597-
> > CakePHP will extend this class.
496+
`Cake\View\Exception\MissingViewException`
497+
: The chosen view class could not be found.
498+
499+
`Cake\View\Exception\MissingTemplateException`
500+
: The chosen template file could not be found.
501+
502+
`Cake\View\Exception\MissingLayoutException`
503+
: The chosen layout could not be found.
504+
505+
`Cake\View\Exception\MissingHelperException`
506+
: The chosen helper could not be found.
507+
508+
`Cake\View\Exception\MissingElementException`
509+
: The chosen element file could not be found.
510+
511+
`Cake\View\Exception\MissingCellException`
512+
: The chosen cell class could not be found.
513+
514+
`Cake\View\Exception\MissingCellViewException`
515+
: The chosen cell view file could not be found.
516+
517+
`Cake\Controller\Exception\MissingComponentException`
518+
: A configured component could not be found.
519+
520+
`Cake\Controller\Exception\MissingActionException`
521+
: The requested controller action could not be found.
522+
523+
`Cake\Controller\Exception\PrivateActionException`
524+
: Accessing private/protected/\_ prefixed actions.
525+
526+
`Cake\Console\Exception\ConsoleException`
527+
: A console library class encounter an error.
528+
529+
`Cake\Database\Exception\MissingConnectionException`
530+
: A model's connection is missing.
531+
532+
`Cake\Database\Exception\MissingDriverException`
533+
: A database driver could not be found.
534+
535+
`Cake\Database\Exception\MissingExtensionException`
536+
: A PHP extension is missing for the database driver.
537+
538+
`Cake\ORM\Exception\MissingTableException`
539+
: A model's table could not be found.
540+
541+
`Cake\ORM\Exception\MissingEntityException`
542+
: A model's entity could not be found.
543+
544+
`Cake\ORM\Exception\MissingBehaviorException`
545+
: A model's behavior could not be found.
546+
547+
`Cake\ORM\Exception\PersistenceFailedException`
548+
: An entity couldn't be saved/deleted while using `Cake\ORM\Table::saveOrFail()` or
549+
`Cake\ORM\Table::deleteOrFail()`.
550+
551+
`Cake\Datasource\Exception\RecordNotFoundException`
552+
: The requested record could not be found. This will also set HTTP response
553+
headers to 404.
554+
555+
`Cake\Routing\Exception\MissingControllerException`
556+
: The requested controller could not be found.
557+
558+
`Cake\Routing\Exception\MissingRouteException`
559+
: The requested URL cannot be reverse routed or cannot be parsed.
560+
561+
`Cake\Core\Exception\CakeException`
562+
: Base exception class in CakePHP. All framework layer exceptions thrown by
563+
CakePHP will extend this class.
598564

599565
These exception classes all extend `Exception`.
600566
By extending Exception, you can create your own 'framework' errors.

0 commit comments

Comments
 (0)