slimphp / Slim

     * @return self A new instance with the specified query string.

     * @throws \InvalidArgumentException for invalid query strings.

     */

    public function withQuery($query)

    {

        if (!is_string($query) && !method_exists($query, '__toString')) {

            throw new InvalidArgumentException('Uri query must be a string');

        }

        $query = ltrim((string)$query, '?');

        $clone = clone $this;

        $clone->query = $this->filterQuery($query);

        return $clone;

    }

    /**

     * Filters the query string or fragment of a URI.

     * @param string $fragment The fragment to use with the new instance.

     * @return self A new instance with the specified fragment.

     */

    public function withFragment($fragment)

    {

        if (!is_string($fragment) && !method_exists($fragment, '__toString')) {

            throw new InvalidArgumentException('Uri fragment must be a string');

        }

        $fragment = ltrim((string)$fragment, '#');

        $clone = clone $this;

        $clone->fragment = $this->filterQuery($fragment);

        return $clone;

    }

    /********************************************************************************

     * Helpers