-
-
-
-
-
-
+
+
+ Skip to content
+ -
-
-
- URL rewriting is not properly configured on your server.
- 1) Help me configure it
- 2) I don't / can't use URL rewriting -
-
+
+
+
+ CakePHP
+
- Welcome to CakePHP 6
+A fresh start for your next idea. Everything you need to build a powerful application, with conventions that keep you moving.
+
-
-
+
-
diff --git a/templates/layout/error.php b/templates/layout/error.php
index 2b26a16da0..25164785a6 100644
--- a/templates/layout/error.php
+++ b/templates/layout/error.php
@@ -15,25 +15,29 @@
*/
?>
-
+
Html->charset() ?>
+
+
<?= $this->fetch('title') ?>
Html->meta('icon') ?>
- Html->css(['normalize.min', 'milligram.min', 'fonts', 'cake']) ?>
+ Html->css('cake') ?>
fetch('meta') ?>
fetch('css') ?>
fetch('script') ?>
-
+
diff --git a/tests/TestCase/Controller/PagesControllerTest.php b/tests/TestCase/Controller/PagesControllerTest.php
index 91f48c0c16..969cf87215 100644
--- a/tests/TestCase/Controller/PagesControllerTest.php
+++ b/tests/TestCase/Controller/PagesControllerTest.php
@@ -41,7 +41,7 @@ public function testDisplay(): void
$this->get('/pages/home');
$this->assertResponseOk();
$this->assertResponseContains('CakePHP');
- $this->assertResponseContains('');
+ $this->assertResponseContains('');
}
/**
diff --git a/tests/TestCase/View/WelcomePageTest.php b/tests/TestCase/View/WelcomePageTest.php
new file mode 100644
index 0000000000..005c5603a7
--- /dev/null
+++ b/tests/TestCase/View/WelcomePageTest.php
@@ -0,0 +1,207 @@
+
+ */
+ protected array $connectionAliases = [];
+
+ protected ?PluginInterface $debugKit = null;
+
+ /**
+ * @inheritDoc
+ */
+ public function setUp(): void
+ {
+ parent::setUp();
+ Configure::write('debug', true);
+ $this->connectionAliases = ConnectionManager::aliases();
+ $plugins = Plugin::getCollection();
+ $this->debugKit = $plugins->has('DebugKit') ? $plugins->get('DebugKit') : null;
+ $plugins->remove('DebugKit');
+ ConnectionManager::setConfig('welcome_default', [
+ 'className' => Connection::class,
+ 'driver' => Sqlite::class,
+ 'database' => ':memory:',
+ ]);
+ ConnectionManager::alias('welcome_default', 'default');
+ }
+
+ /**
+ * @inheritDoc
+ */
+ public function tearDown(): void
+ {
+ foreach (['default', 'debug_kit'] as $name) {
+ ConnectionManager::dropAlias($name);
+ if (isset($this->connectionAliases[$name])) {
+ ConnectionManager::alias($this->connectionAliases[$name], $name);
+ }
+ }
+ ConnectionManager::drop('welcome_default');
+ ConnectionManager::drop('welcome_debug_kit');
+ Plugin::getCollection()->remove('DebugKit');
+ if ($this->debugKit !== null) {
+ Plugin::getCollection()->add($this->debugKit);
+ }
+ parent::tearDown();
+ }
+
+ /**
+ * A real connection renders successfully without the optional plugin.
+ *
+ * @return void
+ */
+ public function testConnectedWithoutDebugKit(): void
+ {
+ $html = (new AppView())->render('Pages/home');
+
+ $this->assertStringContainsString('Connected to your database.', $html);
+ $this->assertStringContainsString('Optional. Enable DebugKit in config/plugins.php.', $html);
+ $this->assertStringNotContainsString('Connection details', $html);
+ $this->assertStringNotContainsString('milligram', $html);
+ $this->assertStringNotContainsString('https://cakephp.org/v2/img/', $html);
+ }
+
+ /**
+ * The standalone page still supports the standard view blocks.
+ *
+ * @return void
+ */
+ public function testViewBlocks(): void
+ {
+ $view = new AppView();
+ $view->assign('title', 'Custom welcome');
+ $view->assign('meta', '');
+ $view->assign('css', '');
+ $view->assign('script', '');
+ $html = $view->render('Pages/home');
+
+ $this->assertStringContainsString('Custom welcome ', $html);
+ $this->assertStringContainsString('', $html);
+ $this->assertStringContainsString('', $html);
+ $this->assertStringContainsString('', $html);
+ }
+
+ /**
+ * Driver exception attributes are escaped rather than rendered as markup.
+ *
+ * @return void
+ */
+ public function testDatabaseFailureIsEscaped(): void
+ {
+ $this->failingConnection('welcome_default');
+ $html = (new AppView())->render('Pages/home');
+
+ $this->assertStringContainsString('Check Datasources in config/app_local.php.', $html);
+ $this->assertStringContainsString('Connection details', $html);
+ $this->assertStringContainsString('<script>alert("connection")</script>', $html);
+ $this->assertStringNotContainsString('', $html);
+ }
+
+ /**
+ * DebugKit retains the actual exception and separately renders trusted help.
+ *
+ * @return void
+ */
+ public function testDebugKitFailureIsEscaped(): void
+ {
+ Plugin::getCollection()->add(new DebugKitPlugin());
+ $this->failingConnection('welcome_debug_kit');
+ ConnectionManager::alias('welcome_debug_kit', 'debug_kit');
+ $html = (new AppView())->render('Pages/home');
+
+ $this->assertStringContainsString('Check the DebugKit database configuration.', $html);
+ $this->assertStringContainsString('<script>alert("connection")</script>', $html);
+ $this->assertStringNotContainsString('', $html);
+ $this->assertStringContainsString('https://book.cakephp.org/debugkit/', $html);
+ }
+
+ /**
+ * DebugKit's successful connection is also reported.
+ *
+ * @return void
+ */
+ public function testDebugKitConnected(): void
+ {
+ Plugin::getCollection()->add(new DebugKitPlugin());
+ ConnectionManager::setConfig('welcome_debug_kit', [
+ 'className' => Connection::class,
+ 'driver' => Sqlite::class,
+ 'database' => ':memory:',
+ ]);
+ ConnectionManager::alias('welcome_debug_kit', 'debug_kit');
+ $html = (new AppView())->render('Pages/home');
+
+ $this->assertStringContainsString('Loaded for development.', $html);
+ $this->assertStringContainsString('Connected to its database.', $html);
+ $this->assertStringNotContainsString('Connection details', $html);
+ }
+
+ /**
+ * Production mode rejects the page before opening a connection.
+ *
+ * @return void
+ */
+ public function testProductionDoesNotConnect(): void
+ {
+ Configure::write('debug', false);
+ $connection = $this->createMock(Connection::class);
+ $connection->expects($this->never())->method('getDriver');
+ ConnectionManager::drop('welcome_default');
+ ConnectionManager::setConfig('welcome_default', $connection);
+
+ $this->expectException(NotFoundException::class);
+ (new AppView())->render('Pages/home');
+ }
+
+ /**
+ * Configure a driver that fails with unsafe exception text.
+ *
+ * @param string $name Connection name.
+ * @return void
+ */
+ protected function failingConnection(string $name): void
+ {
+ $driver = $this->createMock(Sqlite::class);
+ $driver->expects($this->once())->method('connect')->willThrowException(new MissingConnectionException([
+ 'driver' => 'Sqlite',
+ 'message' => '',
+ ]));
+ $connection = $this->createMock(Connection::class);
+ $connection->expects($this->once())->method('getDriver')->willReturn($driver);
+ ConnectionManager::drop($name);
+ ConnectionManager::setConfig($name, $connection);
+ }
+}
-
- Environment
--
- =')) : ?>
-
- Your version of PHP is 8.5.0 or higher (detected ). - -
- Your version of PHP is too low. You need PHP 8.5.0 or higher to use CakePHP (detected ). - - - -
- Your version of PHP has the mbstring extension loaded. - -
- Your version of PHP does NOT have the mbstring extension loaded. - - - -
- Your version of PHP has the openssl extension loaded. - -
- Your version of PHP does NOT have the openssl extension loaded. - - - -
- Your version of PHP has the intl extension loaded. - -
- Your version of PHP does NOT have the intl extension loaded. - - - -
- You should set
zend.assertionsto1in yourphp.inifor your development environment.
-
-
-
+
- Filesystem
--
-
-
- Your tmp directory is writable. - -
- Your tmp directory is NOT writable. - - - -
- Your logs directory is writable. - -
- Your logs directory is NOT writable. - - - - -
- The engine is being used for translations caching. To change the config edit
config/app.php
-
- - Your translations cache is NOT working. Please check the settings in config/app.php - -
-
-
-
<?= $cakeDescription ?>:
<?= $this->fetch('title') ?>
Html->meta('icon') ?>
- Html->css(['normalize.min', 'milligram.min', 'fonts', 'cake']) ?>
+ Html->css('cake') ?>
fetch('meta') ?>
fetch('css') ?>
fetch('script') ?>
-
-
-
- Database
- --
-
-
- CakePHP is able to connect to the database. - -
- CakePHP is NOT able to connect to the database.
- The engine is being used for database schema caching. To change the config edit config/app.php - -
- Your database schema cache is NOT working. Please check the settings in
config/app.php
-
+
+ -
+
+
+
+
+
+
+
+ ++ +
Connection details
+ +
+
- DebugKit is loaded. - - -
- DebugKit can connect to the database. - -
- There are configuration problems present which need to be fixed:
- DebugKit is not loaded. + +
+
+ Your development setup
+A few checks before you get started.
+
+ $section) : ?>
+
+
+
+
- -
+
+
-
+ DebugKit
--
-
-
Toolbar not showing? Check DebugKit configuration, including DebugKit.safeTld.
-
-
+
+
+
diff --git a/templates/element/flash/default.php b/templates/element/flash/default.php
index 061c700920..f6f9b77d2b 100644
--- a/templates/element/flash/default.php
+++ b/templates/element/flash/default.php
@@ -12,4 +12,7 @@
$message = h($message);
}
?>
-
+
+
+
+
diff --git a/templates/element/flash/error.php b/templates/element/flash/error.php
index 2ebf2357c0..90e7424dd6 100644
--- a/templates/element/flash/error.php
+++ b/templates/element/flash/error.php
@@ -8,4 +8,7 @@
$message = h($message);
}
?>
-
+
diff --git a/templates/element/flash/info.php b/templates/element/flash/info.php
index e25b730c4f..602019b8fb 100644
--- a/templates/element/flash/info.php
+++ b/templates/element/flash/info.php
@@ -8,4 +8,7 @@
$message = h($message);
}
?>
-
+
diff --git a/templates/element/flash/success.php b/templates/element/flash/success.php
index 73eaac48d3..53840253a2 100644
--- a/templates/element/flash/success.php
+++ b/templates/element/flash/success.php
@@ -8,4 +8,7 @@
$message = h($message);
}
?>
-
+
diff --git a/templates/element/flash/warning.php b/templates/element/flash/warning.php
index 605537c7e2..e1d1fa075a 100644
--- a/templates/element/flash/warning.php
+++ b/templates/element/flash/warning.php
@@ -8,4 +8,7 @@
$message = h($message);
}
?>
-
+
diff --git a/templates/layout/default.php b/templates/layout/default.php
index 3a3e3d9ff5..fc4a3b14e9 100644
--- a/templates/layout/default.php
+++ b/templates/layout/default.php
@@ -17,24 +17,26 @@
$cakeDescription = 'CakePHP: the rapid development php framework';
?>
-
+
Html->charset() ?>
+
Flash->render() ?>
fetch('content') ?>
- Flash->render() ?>
- fetch('content') ?>
- Html->link(__('Back'), 'javascript:history.back()') ?>
-
+
+ Flash->render() ?>
+ fetch('content') ?>
+ Html->link(__('Back'), 'javascript:history.back()') ?>
+
+