bootstrap(); self::$cookieJar = new CookieJar; self::$client = new Goutte\Client(array(), null, self::$cookieJar); // Reset the curl handle because it is 0 at this point and not a valid // resource self::$client->getClient()->getCurlMulti()->reset(true); // Clear the language array so that things // that were added in other tests are gone $this->lang = array(); $this->add_lang('common'); $this->purge_cache(); } /** * Perform a request to page * * @param string $method HTTP Method * @param string $path Page path, relative from phpBB root path * @param array $form_data An array of form field values * @param bool $assert_response_html Should we perform standard assertions for a normal html page * @return Symfony\Component\DomCrawler\Crawler */ static public function request($method, $path, $form_data = array(), $assert_response_html = true) { $crawler = self::$client->request($method, self::$root_url . $path, $form_data); if ($assert_response_html) { self::assert_response_html(); } return $crawler; } /** * Submits a form * * @param Symfony\Component\DomCrawler\Form $form A Form instance * @param array $values An array of form field values * @param bool $assert_response_html Should we perform standard assertions for a normal html page * @return Symfony\Component\DomCrawler\Crawler */ static public function submit(Symfony\Component\DomCrawler\Form $form, array $values = array(), $assert_response_html = true) { $crawler = self::$client->submit($form, $values); if ($assert_response_html) { self::assert_response_html(); } return $crawler; } /** * Get Client Content * * @return string HTML page */ static public function get_content() { return self::$client->getResponse()->getContent(); } // bootstrap, called after board is set up // once per test case class // test cases can override this protected function bootstrap() { } public function __construct($name = NULL, array $data = array(), $dataName = '') { parent::__construct($name, $data, $dataName); $this->backupStaticAttributesBlacklist += array( 'phpbb_functional_test_case' => array('config', 'already_installed'), ); } protected function get_db() { global $phpbb_root_path, $phpEx; // so we don't reopen an open connection if (!($this->db instanceof phpbb_db_driver)) { $dbms = self::$config['dbms']; $this->db = new $dbms(); $this->db->sql_connect(self::$config['dbhost'], self::$config['dbuser'], self::$config['dbpasswd'], self::$config['dbname'], self::$config['dbport']); } return $this->db; } protected function get_cache_driver() { if (!$this->cache) { $this->cache = new phpbb_cache_driver_file; } return $this->cache; } protected function purge_cache() { $cache = $this->get_cache_driver(); $cache->purge(); $cache->unload(); $cache->load(); } protected function get_extension_manager() { global $phpbb_root_path, $phpEx; $config = new phpbb_config(array()); $db = $this->get_db(); $db_tools = new phpbb_db_tools($db); $migrator = new phpbb_db_migrator( $config, $db, $db_tools, self::$config['table_prefix'] . 'migrations', $phpbb_root_path, $php_ext, self::$config['table_prefix'], array() ); $container = new phpbb_mock_container_builder(); $container->set('migrator', $migrator); $extension_manager = new phpbb_extension_manager( $container, $db, $config, new phpbb_filesystem(), self::$config['table_prefix'] . 'ext', dirname(__FILE__) . '/', $php_ext, $this->get_cache_driver() ); return $extension_manager; } static protected function install_board() { global $phpbb_root_path, $phpEx; self::recreate_database(self::$config); if (file_exists($phpbb_root_path . "config.$phpEx")) { if (!file_exists($phpbb_root_path . "config_dev.$phpEx")) { rename($phpbb_root_path . "config.$phpEx", $phpbb_root_path . "config_dev.$phpEx"); } else { unlink($phpbb_root_path . "config.$phpEx"); } } self::$cookieJar = new CookieJar; self::$client = new Goutte\Client(array(), null, self::$cookieJar); // Set client manually so we can increase the cURL timeout self::$client->setClient(new Guzzle\Http\Client('', array( Guzzle\Http\Client::DISABLE_REDIRECTS => true, 'curl.options' => array( CURLOPT_TIMEOUT => 120, ), ))); // Reset the curl handle because it is 0 at this point and not a valid // resource self::$client->getClient()->getCurlMulti()->reset(true); $parseURL = parse_url(self::$config['phpbb_functional_url']); $crawler = self::request('GET', 'install/index.php?mode=install'); self::assertContains('Welcome to Installation', $crawler->filter('#main')->text()); $form = $crawler->selectButton('submit')->form(); $crawler = self::submit($form); self::assertContains('Installation compatibility', $crawler->filter('#main')->text()); $form = $crawler->selectButton('submit')->form(); $crawler = self::submit($form); self::assertContains('Database configuration', $crawler->filter('#main')->text()); $form = $crawler->selectButton('submit')->form(array( // Installer uses 3.0-style dbms name 'dbms' => str_replace('phpbb_db_driver_', '', self::$config['dbms']), 'dbhost' => self::$config['dbhost'], 'dbport' => self::$config['dbport'], 'dbname' => self::$config['dbname'], 'dbuser' => self::$config['dbuser'], 'dbpasswd' => self::$config['dbpasswd'], 'table_prefix' => self::$config['table_prefix'], )); $crawler = self::submit($form); self::assertContains('Successful connection', $crawler->filter('#main')->text()); $form = $crawler->selectButton('submit')->form(); $crawler = self::submit($form); self::assertContains('Administrator configuration', $crawler->filter('#main')->text()); $form = $crawler->selectButton('submit')->form(array( 'default_lang' => 'en', 'admin_name' => 'admin', 'admin_pass1' => 'adminadmin', 'admin_pass2' => 'adminadmin', 'board_email' => 'nobody@example.com', )); $crawler = self::submit($form); self::assertContains('Tests passed', $crawler->filter('#main')->text()); $form = $crawler->selectButton('submit')->form(); $crawler = self::submit($form); self::assertContains('The configuration file has been written.', $crawler->filter('#main')->text()); file_put_contents($phpbb_root_path . "config.$phpEx", phpbb_create_config_file_data(self::$config, self::$config['dbms'], true, true)); $form = $crawler->selectButton('submit')->form(); $crawler = self::submit($form); self::assertContains('The settings on this page are only necessary to set if you know that you require something different from the default.', $crawler->filter('#main')->text()); $form = $crawler->selectButton('submit')->form(array( 'email_enable' => true, 'smtp_delivery' => true, 'smtp_host' => 'nxdomain.phpbb.com', 'smtp_auth' => 'PLAIN', 'smtp_user' => 'nxuser', 'smtp_pass' => 'nxpass', 'cookie_secure' => false, 'force_server_vars' => false, 'server_protocol' => $parseURL['scheme'] . '://', 'server_name' => 'localhost', 'server_port' => isset($parseURL['port']) ? (int) $parseURL['port'] : 80, 'script_path' => $parseURL['path'], )); $crawler = self::submit($form); self::assertContains('The database tables used by phpBB', $crawler->filter('#main')->text()); self::assertContains('have been created and populated with some initial data.', $crawler->filter('#main')->text()); $form = $crawler->selectButton('submit')->form(); $crawler = self::submit($form); self::assertContains('You have successfully installed', $crawler->text()); copy($phpbb_root_path . "config.$phpEx", $phpbb_root_path . "config_test.$phpEx"); } static private function recreate_database($config) { $db_conn_mgr = new phpbb_database_test_connection_manager($config); $db_conn_mgr->recreate_db(); } /** * Creates a new user with limited permissions * * @param string $username Also doubles up as the user's password * @return int ID of created user */ protected function create_user($username) { // Required by unique_id global $config; $config = new phpbb_config(array()); $config['rand_seed'] = ''; $config['rand_seed_last_update'] = time() + 600; // Required by user_add global $db, $cache, $phpbb_dispatcher, $phpbb_container; $db = $this->get_db(); if (!function_exists('phpbb_mock_null_cache')) { require_once(__DIR__ . '/../mock/null_cache.php'); } $cache = new phpbb_mock_null_cache; $cache_driver = new phpbb_cache_driver_null(); $phpbb_container = $this->getMock('Symfony\Component\DependencyInjection\ContainerInterface'); $phpbb_container ->expects($this->any()) ->method('get') ->with('cache.driver') ->will($this->returnValue($cache_driver)); if (!function_exists('utf_clean_string')) { require_once(__DIR__ . '/../../phpBB/includes/utf/utf_tools.php'); } if (!function_exists('user_add')) { require_once(__DIR__ . '/../../phpBB/includes/functions_user.php'); } set_config(null, null, null, $config); set_config_count(null, null, null, $config); $phpbb_dispatcher = new phpbb_mock_event_dispatcher(); $user_row = array( 'username' => $username, 'group_id' => 2, 'user_email' => 'nobody@example.com', 'user_type' => 0, 'user_lang' => 'en', 'user_timezone' => 0, 'user_dateformat' => '', 'user_password' => phpbb_hash($username . $username), ); return user_add($user_row); } protected function remove_user_group($group_name, $usernames) { global $db, $cache, $auth, $config, $phpbb_dispatcher, $phpbb_log, $phpbb_container, $phpbb_root_path, $phpEx; $config = new phpbb_config(array()); $config['coppa_enable'] = 0; $db = $this->get_db(); $phpbb_dispatcher = new phpbb_mock_event_dispatcher(); $user = $this->getMock('phpbb_user'); $auth = $this->getMock('phpbb_auth'); $phpbb_log = new phpbb_log($db, $user, $auth, $phpbb_dispatcher, $phpbb_root_path, 'adm/', $phpEx, LOG_TABLE); $cache = new phpbb_mock_null_cache; $cache_driver = new phpbb_cache_driver_null(); $phpbb_container = $this->getMock('Symfony\Component\DependencyInjection\ContainerInterface'); $phpbb_container ->expects($this->any()) ->method('get') ->with('cache.driver') ->will($this->returnValue($cache_driver)); if (!function_exists('utf_clean_string')) { require_once(__DIR__ . '/../../phpBB/includes/utf/utf_tools.php'); } if (!function_exists('group_user_del')) { require_once(__DIR__ . '/../../phpBB/includes/functions_user.php'); } $sql = 'SELECT group_id FROM ' . GROUPS_TABLE . " WHERE group_name = '" . $db->sql_escape($group_name) . "'"; $result = $db->sql_query($sql); $group_id = (int) $db->sql_fetchfield('group_id'); $db->sql_freeresult($result); return group_user_del($group_id, false, $usernames, $group_name); } protected function add_user_group($group_name, $usernames, $default = false, $leader = false) { global $db, $cache, $auth, $config, $phpbb_dispatcher, $phpbb_log, $phpbb_container, $phpbb_root_path, $phpEx; $config = new phpbb_config(array()); $config['coppa_enable'] = 0; $db = $this->get_db(); $phpbb_dispatcher = new phpbb_mock_event_dispatcher(); $user = $this->getMock('phpbb_user'); $auth = $this->getMock('phpbb_auth'); $phpbb_log = new phpbb_log($db, $user, $auth, $phpbb_dispatcher, $phpbb_root_path, 'adm/', $phpEx, LOG_TABLE); $cache = new phpbb_mock_null_cache; $cache_driver = new phpbb_cache_driver_null(); $phpbb_container = $this->getMock('Symfony\Component\DependencyInjection\ContainerInterface'); $phpbb_container ->expects($this->any()) ->method('get') ->with('cache.driver') ->will($this->returnValue($cache_driver)); if (!function_exists('utf_clean_string')) { require_once(__DIR__ . '/../../phpBB/includes/utf/utf_tools.php'); } if (!function_exists('group_user_del')) { require_once(__DIR__ . '/../../phpBB/includes/functions_user.php'); } $sql = 'SELECT group_id FROM ' . GROUPS_TABLE . " WHERE group_name = '" . $db->sql_escape($group_name) . "'"; $result = $db->sql_query($sql); $group_id = (int) $db->sql_fetchfield('group_id'); $db->sql_freeresult($result); return group_user_add($group_id, false, $usernames, $group_name, $default, $leader); } protected function login($username = 'admin') { $this->add_lang('ucp'); $crawler = self::request('GET', 'ucp.php'); $this->assertContains($this->lang('LOGIN_EXPLAIN_UCP'), $crawler->filter('html')->text()); $form = $crawler->selectButton($this->lang('LOGIN'))->form(); $crawler = self::submit($form, array('username' => $username, 'password' => $username . $username)); $this->assertContains($this->lang('LOGIN_REDIRECT'), $crawler->filter('html')->text()); $cookies = self::$cookieJar->all(); // The session id is stored in a cookie that ends with _sid - we assume there is only one such cookie foreach ($cookies as $cookie); { if (substr($cookie->getName(), -4) == '_sid') { $this->sid = $cookie->getValue(); } } } protected function logout() { $this->add_lang('ucp'); $crawler = self::request('GET', 'ucp.php?sid=' . $this->sid . '&mode=logout'); $this->assertContains($this->lang('LOGOUT_REDIRECT'), $crawler->filter('#message')->text()); unset($this->sid); } /** * Login to the ACP * You must run login() before calling this. */ protected function admin_login($username = 'admin') { $this->add_lang('acp/common'); // Requires login first! if (empty($this->sid)) { $this->fail('$this->sid is empty. Make sure you call login() before admin_login()'); return; } $crawler = self::request('GET', 'adm/index.php?sid=' . $this->sid); $this->assertContains($this->lang('LOGIN_ADMIN_CONFIRM'), $crawler->filter('html')->text()); $form = $crawler->selectButton($this->lang('LOGIN'))->form(); foreach ($form->getValues() as $field => $value) { if (strpos($field, 'password_') === 0) { $crawler = self::submit($form, array('username' => $username, $field => $username . $username)); $this->assertContains($this->lang('LOGIN_ADMIN_SUCCESS'), $crawler->filter('html')->text()); $cookies = self::$cookieJar->all(); // The session id is stored in a cookie that ends with _sid - we assume there is only one such cookie foreach ($cookies as $cookie); { if (substr($cookie->getName(), -4) == '_sid') { $this->sid = $cookie->getValue(); } } break; } } } protected function add_lang($lang_file) { if (is_array($lang_file)) { foreach ($lang_file as $file) { $this->add_lang($file); } } $lang_path = __DIR__ . "/../../phpBB/language/en/$lang_file.php"; $lang = array(); if (file_exists($lang_path)) { include($lang_path); } $this->lang = array_merge($this->lang, $lang); } protected function lang() { $args = func_get_args(); $key = $args[0]; if (empty($this->lang[$key])) { throw new RuntimeException('Language key "' . $key . '" could not be found.'); } $args[0] = $this->lang[$key]; return call_user_func_array('sprintf', $args); } /** * assertContains for language strings * * @param string $needle Search string * @param string $haystack Search this * @param string $message Optional failure message */ public function assertContainsLang($needle, $haystack, $message = null) { $this->assertContains(html_entity_decode($this->lang($needle), ENT_QUOTES), $haystack, $message); } /* * Perform some basic assertions for the page * * Checks for debug/error output before the actual page content and the status code * * @param mixed $status_code Expected status code, false to disable check * @return null */ static public function assert_response_html($status_code = 200) { if ($status_code !== false) { self::assert_response_status_code($status_code); } // Any output before the doc type means there was an error $content = self::$client->getResponse()->getContent(); self::assertStringStartsWith('getResponse()->getStatus()); } public function assert_filter($crawler, $expr, $msg = null) { $nodes = $crawler->filter($expr); if ($msg) { $msg .= "\n"; } else { $msg = ''; } $msg .= "`$expr` not found in DOM."; $this->assertGreaterThan(0, count($nodes), $msg); return $nodes; } /** * Asserts that exactly one checkbox with name $name exists within the scope * of $crawler and that the checkbox is checked. * * @param Symfony\Component\DomCrawler\Crawler $crawler * @param string $name * @param string $message * * @return null */ public function assert_checkbox_is_checked($crawler, $name, $message = '') { $this->assertSame( 'checked', $this->assert_find_one_checkbox($crawler, $name)->attr('checked'), $message ?: "Failed asserting that checkbox $name is checked." ); } /** * Asserts that exactly one checkbox with name $name exists within the scope * of $crawler and that the checkbox is unchecked. * * @param Symfony\Component\DomCrawler\Crawler $crawler * @param string $name * @param string $message * * @return null */ public function assert_checkbox_is_unchecked($crawler, $name, $message = '') { $this->assertSame( '', $this->assert_find_one_checkbox($crawler, $name)->attr('checked'), $message ?: "Failed asserting that checkbox $name is unchecked." ); } /** * Searches for an input element of type checkbox with the name $name using * $crawler. Contains an assertion that only one such checkbox exists within * the scope of $crawler. * * @param Symfony\Component\DomCrawler\Crawler $crawler * @param string $name * @param string $message * * @return Symfony\Component\DomCrawler\Crawler */ public function assert_find_one_checkbox($crawler, $name, $message = '') { $query = sprintf('//input[@type="checkbox" and @name="%s"]', $name); $result = $crawler->filterXPath($query); $this->assertEquals( 1, sizeof($result), $message ?: 'Failed asserting that exactly one checkbox with name' . " $name exists in crawler scope." ); return $result; } }