wfUrlencodeTest.php

Go to the documentation of this file.

<?php
class wfUrlencodeTest extends MediaWikiTestCase {

        #### TESTS ##############################################################
        
        public function testEncodingUrlWith( $input, $expected ) {
                $this->verifyEncodingFor( 'Apache', $input, $expected );
        }

        public function testEncodingUrlWithMicrosoftIis7( $input, $expected ) {
                $this->verifyEncodingFor( 'Microsoft-IIS/7', $input, $expected );
        }

        #### HELPERS #############################################################
        
        private function verifyEncodingFor( $server, $input, $expectations ) {
                $expected = $this->extractExpect( $server, $expectations );

                // save up global
                $old = isset($_SERVER['SERVER_SOFTWARE'])
                        ? $_SERVER['SERVER_SOFTWARE']
                        : null
                ;
                $_SERVER['SERVER_SOFTWARE'] = $server;
                wfUrlencode( null );

                // do the requested test
                $this->assertEquals(
                        $expected,
                        wfUrlencode( $input ),
                        "Encoding '$input' for server '$server' should be '$expected'"
                );

                // restore global
                if( $old === null ) {
                        unset( $_SERVER['SERVER_SOFTWARE'] );
                } else {
                        $_SERVER['SERVER_SOFTWARE'] = $old;
                }
                wfUrlencode( null );
        }

        private function extractExpect( $server, $expectations ) {
                if( is_string( $expectations ) ) {
                        return $expectations;
                } elseif( is_array( $expectations ) ) {
                        if( !array_key_exists( $server, $expectations ) ) {
                                throw new MWException( __METHOD__ . " expectation does not have any value for server name $server. Check the provider array.\n" );
                        } else {
                                return $expectations[$server];
                        }
                } else {
                        throw new MWException( __METHOD__ . " given invalid expectation for '$server'. Should be a string or an array( <http server name> => <string> ).\n" );
                }
        }  


        #### PROVIDERS ###########################################################

        public function provideURLS() {
                return array(
                ### RFC 1738 chars      
                        // + is not safe
                        array( '+', '%2B' ),
                        // & and = not safe in queries
                        array( '&', '%26' ),
                        array( '=', '%3D' ),

                        array( ':', array(
                                'Apache'          => ':',
                                'Microsoft-IIS/7' => '%3A',
                        ) ),

                        // remaining chars do not need encoding
                        array(
                                ';@$-_.!*',
                                ';@$-_.!*',
                        ),

                ### Other tests
                        // slash remain unchanged. %2F seems to break things
                        array( '/', '/' ),
        
                        // Other 'funnies' chars
                        array( '[]', '%5B%5D' ),
                        array( '<>', '%3C%3E' ),

                        // Apostrophe is encoded
                        array( '\'', '%27' ),
                );
        }
}