url

5 common.inc	`url($path = NULL, $query = NULL, $fragment = NULL, $absolute = FALSE)`
6 common.inc	`url($path = NULL, $options = array())`
7 common.inc	`url($path = NULL, array $options = array())`
8 common.inc	`url($path = NULL, array $options = array())`

Generates an internal or external URL.

When creating links in modules, consider whether l() could be a better alternative than url().

Parameters

$path: The internal path or external URL being linked to, such as "node/34" or "http://example.com/foo". A few notes:

If you provide a full URL, it will be considered an external URL.
If you provide only the path (e.g. "node/34"), it will be considered an internal link. In this case, it should be a system URL, and it will be replaced with the alias, if one exists. Additional query arguments for internal paths must be supplied in $options['query'], not included in $path.
If you provide an internal path and $options['alias'] is set to TRUE, the path is assumed already to be the correct path alias, and the alias is not looked up.
The special string '<front>' generates a link to the site's base URL.
If your external URL contains a query (e.g. http://example.com/foo?a=b), then you can either URL encode the query keys and values yourself and include them in $path, or use $options['query'] to let this function URL encode them.

$options: An associative array of additional options, with the following elements:

'query': An array of query key/value-pairs (without any URL-encoding) to append to the URL.
'fragment': A fragment identifier (named anchor) to append to the URL. Do not include the leading '#' character.
'absolute': Defaults to FALSE. Whether to force the output to be an absolute link (beginning with http:). Useful for links that will be displayed outside the site, such as in an RSS feed.
'alias': Defaults to FALSE. Whether the given path is a URL alias already.
'external': Whether the given path is an external URL.
'language': An optional language object. If the path being linked to is internal to the site, $options['language'] is used to look up the alias for the URL. If $options['language'] is omitted, the global $language_url will be used.
'https': Whether this URL should point to a secure location. If not defined, the current scheme is used, so the user stays on http or https respectively. TRUE enforces HTTPS and FALSE enforces HTTP, but HTTPS can only be enforced when the variable 'https' is set to TRUE.
'base_url': Only used internally, to modify the base URL when a language dependent URL requires so.
'prefix': Only used internally, to modify the path when a language dependent URL requires so.
'script': The script filename in Drupal's root directory to use when clean URLs are disabled, such as 'index.php'. Defaults to an empty string, as most modern web servers automatically find 'index.php'. If clean URLs are disabled, the value of $path is appended as query parameter 'q' to $options['script'] in the returned URL. When deploying Drupal on a web server that cannot be configured to automatically find index.php, then hook_url_outbound_alter() can be implemented to force this value to 'index.php'.
'entity_type': The entity type of the object that called url(). Only set if url() is invoked by entity_uri().
'entity': The entity object (such as a node) for which the URL is being generated. Only set if url() is invoked by entity_uri().

Return value

A string containing a URL to the given path.

▸ 282 functions call url()

▾ 282 functions call url()

AddFeedTestCase::testAddFeed in modules/aggregator/aggregator.test: Create a feed, ensure that it is unique, check the source, and delete the feed.
AggregatorRenderingTestCase::testBlockLinks in modules/aggregator/aggregator.test: Add a feed block to the page and checks its links.
AggregatorTestCase::getFeedEditArray in modules/aggregator/aggregator.test: Return a randomly generated feed edit array.
aggregator_form_aggregator_admin_form_alter in modules/aggregator/aggregator.processor.inc: Implements hook_form_aggregator_admin_form_alter().
aggregator_form_feed in modules/aggregator/aggregator.admin.inc: Form constructor for adding and editing feed sources.
aggregator_form_opml in modules/aggregator/aggregator.admin.inc: Form constructor for importing feeds from OPML.
aggregator_help in modules/aggregator/aggregator.module: Implements hook_help().
aggregator_page_categories in modules/aggregator/aggregator.pages.inc: Menu callback; displays all the categories used by the aggregator.
aggregator_page_sources in modules/aggregator/aggregator.pages.inc: Menu callback; displays all the feeds used by the aggregator.
aggregator_view in modules/aggregator/aggregator.admin.inc: Displays the aggregator administration page.
AJAXFrameworkTestCase::testAJAXRender in modules/simpletest/tests/ajax.test: Test that ajax_render() returns JavaScript settings generated during the page request.
ajax_pre_render_element in includes/ajax.inc: Adds Ajax information about an element to communicate with JavaScript.
BasicMinimalUpdatePath::testBasicMinimalUpdate in modules/simpletest/tests/upgrade/upgrade.test: Tests a successful point release update.
BasicStandardUpdatePath::testBasicStandardUpdate in modules/simpletest/tests/upgrade/upgrade.test: Tests a successful point release update.
BasicUpgradePath::testBasicUpgrade in modules/simpletest/tests/upgrade/upgrade.test: Test a successful upgrade.
batch_process in includes/form.inc: Processes the batch.
block_custom_block_form in modules/block/block.module: Form constructor for the custom block form.
block_help in modules/block/block.module: Implements hook_help().
block_update_7004 in modules/block/block.install: Add new blocks to new regions, migrate custom variables to blocks.
blog_feed_last in modules/blog/blog.pages.inc: Menu callback; displays an RSS feed containing recent blog entries of all users.
blog_feed_user in modules/blog/blog.pages.inc: Menu callback; displays an RSS feed containing recent blog entries of a given user.
blog_help in modules/blog/blog.module: Implements hook_help().
BookTestCase::checkBookNode in modules/book/book.test: Check the outline of sub-pages; previous, up, and next; and printer friendly version.
book_help in modules/book/book.module: Implements hook_help().
color_help in modules/color/color.module: Implements hook_help().
color_update_7001 in modules/color/color.install: Warn site administrator if unsafe CSS color codes are found in the database.
CommentRSSUnitTest::testCommentRSS in modules/comment/comment.test: Test comments as part of an RSS feed.
CommentTokenReplaceTestCase::testCommentTokenReplacement in modules/comment/comment.test: Creates a comment, then tests the tokens generated from it.
comment_form in modules/comment/comment.module: Generate the basic commenting form, for appending to a node or display on a separate page.
comment_help in modules/comment/comment.module: Implements hook_help().
comment_node_view in modules/comment/comment.module: Implements hook_node_view().
comment_tokens in modules/comment/comment.tokens.inc: Implements hook_tokens().
CommonURLUnitTest::testExternalUrls in modules/simpletest/tests/common.test: Test external URL handling.
CommonURLUnitTest::testLXSS in modules/simpletest/tests/common.test: Confirm that invalid text given as $path is filtered.
CommonURLUnitTest::testUrl in modules/simpletest/tests/common.test: Test url() with/without query, with/without fragment, absolute on/off and assert all that works when clean URLs are on and off.
contact_form_user_profile_form_alter in modules/contact/contact.module: Implements hook_form_FORM_ID_alter().
contact_help in modules/contact/contact.module: Implements hook_help().
contact_mail in modules/contact/contact.module: Implements hook_mail().
contact_site_form in modules/contact/contact.pages.inc: Form constructor for the site-wide contact form.
dashboard_admin in modules/dashboard/dashboard.module: Dashboard page callback.
dashboard_help in modules/dashboard/dashboard.module: Implements hook_help().
DateTimeFunctionalTest::testDateFormatConfiguration in modules/system/system.test: Test date format configuration.
DateTimeFunctionalTest::testDateTypeConfiguration in modules/system/system.test: Test date type configuration.
dblog_form_system_logging_settings_alter in modules/dblog/dblog.module: Implements hook_form_FORM_ID_alter().
dblog_help in modules/dblog/dblog.module: Implements hook_help().
DrupalAddFeedTestCase::testBasicFeedAddNoTitle in modules/simpletest/tests/common.test: Test drupal_add_feed() with paths, URLs, and titles.
DrupalGotoTest::testDrupalGoto in modules/simpletest/tests/common.test: Test drupal_goto().
DrupalHTTPRequestTestCase::testDrupalHTTPRequest in modules/simpletest/tests/common.test
DrupalHTTPRequestTestCase::testDrupalHTTPRequestBasicAuth in modules/simpletest/tests/common.test
DrupalHTTPRequestTestCase::testDrupalHTTPRequestRedirect in modules/simpletest/tests/common.test
DrupalPrivateStreamWrapper::getExternalUrl in includes/stream_wrappers.inc: Overrides getExternalUrl().
DrupalRenderTestCase::testDrupalRenderFormElements in modules/simpletest/tests/common.test: Test rendering form elements without passing through form_builder().
DrupalTemporaryStreamWrapper::getExternalUrl in includes/stream_wrappers.inc: Overrides getExternalUrl().
DrupalWebTestCase::assertUrl in modules/simpletest/drupal_web_test_case.php: Pass if the internal browser's URL matches the given path.
DrupalWebTestCase::drupalGet in modules/simpletest/drupal_web_test_case.php: Retrieves a Drupal path or an absolute path.
DrupalWebTestCase::drupalHead in modules/simpletest/drupal_web_test_case.php: Retrieves only the headers for a Drupal path or an absolute path.
drupal_add_feed in includes/common.inc: Adds a feed URL for the current page.
drupal_add_js in includes/common.inc: Adds a JavaScript file, setting, or inline code to the page.
drupal_goto in includes/common.inc: Sends the user to a different Drupal page.
drupal_validate_form in includes/form.inc: Validates user-submitted form data from the $form_state using the validate functions defined in a structured form array.
field_help in modules/field/field.module: Implements hook_help().
field_sql_storage_help in modules/field/modules/field_sql_storage/field_sql_storage.module: Implements hook_help().
field_ui_display_overview_form in modules/field_ui/field_ui.admin.inc: Form constructor for the field display settings for a given view mode.
field_ui_display_overview_form_submit in modules/field_ui/field_ui.admin.inc: Form submission handler for field_ui_display_overview_form().
field_ui_help in modules/field_ui/field_ui.module: Implements hook_help().
file_help in modules/file/file.module: Implements hook_help().
FilledMinimalUpdatePath::testFilledStandardUpdate in modules/simpletest/tests/upgrade/upgrade.test: Tests a successful point release update.
FilledStandardUpdatePath::testFilledStandardUpdate in modules/simpletest/tests/upgrade/upgrade.test: Tests a successful point release update.
filter_help in modules/filter/filter.module: Implements hook_help().
filter_update_7005 in modules/filter/filter.install: Integrate text formats with the user permissions system.
FormsRebuildTestCase::testPreserveFormActionAfterAJAX in modules/simpletest/tests/form.test: Tests that a form's action is retained after an Ajax submission.
forum_confirm_delete in modules/forum/forum.admin.inc: Returns a confirmation page for deleting a forum taxonomy term.
forum_help in modules/forum/forum.module: Implements hook_help().
forum_menu_local_tasks_alter in modules/forum/forum.module: Implements hook_menu_local_tasks_alter().
forum_overview in modules/forum/forum.admin.inc: Returns an overview list of existing forums and containers
help_help in modules/help/help.module: Implements hook_help().
HookBootExitTestCase::testHookBootExit in modules/simpletest/tests/bootstrap.test: Test calling of hook_boot() and hook_exit().
hook_help in modules/help/help.api.php: Provide online user help.
hook_mail in modules/system/system.api.php: Prepare a message based on parameters; called from drupal_mail().
hook_requirements in modules/system/system.api.php: Check installation requirements and do status reporting.
hook_search_execute in modules/search/search.api.php: Execute a search for a set of key words.
hook_tokens in modules/system/system.api.php: Provide replacement values for placeholder tokens.
hook_user_login in modules/user/user.api.php: The user just logged in.
image_help in modules/image/image.module: Implement of hook_help().
image_style_url in modules/image/image.module: Return the URL for an image derivative given a style and image path.
install_finished in includes/install.core.inc: Installation task; perform final steps and display a 'finished' page.
JavaScriptTestCase::testAddFile in modules/simpletest/tests/common.test: Test adding a JavaScript file.
l in includes/common.inc: Formats an internal or external URL link as an HTML anchor tag.
list_help in modules/field/modules/list/list.module: Implements hook_help().
LocaleConfigurationTest::testLanguageConfiguration in modules/locale/locale.test: Functional tests for adding, editing and deleting languages.
LocaleImportFunctionalTest::testStandalonePoFile in modules/locale/locale.test: Test import of standalone .po files.
LocaleTranslationFunctionalTest::testStringTranslation in modules/locale/locale.test: Adds a language and tests string translation by users with the appropriate permissions.
LocaleUrlRewritingTest::checkUrl in modules/locale/locale.test: Check URL rewriting for the given language.
LocaleUserCreationTest::testLocalUserCreation in modules/locale/locale.test: Functional test for language handling during user creation.
locale_form_node_type_form_alter in modules/locale/locale.module: Implements hook_form_FORM_ID_alter().
locale_help in modules/locale/locale.module: Implements hook_help().
locale_languages_predefined_form_submit in modules/locale/locale.admin.inc: Process the language addition form submission.
MenuBreadcrumbTestCase::testBreadCrumbs in modules/simpletest/tests/menu.test: Tests breadcrumbs on node and administrative paths.
MenuRouterTestCase::testAuthUserUserLogin in modules/simpletest/tests/menu.test: Test that an authenticated user hitting 'user/login' gets redirected to 'user' and 'user/register' gets redirected to the user edit page.
MenuWebTestCase::assertBreadcrumb in modules/simpletest/tests/menu.test: Assert that a given path shows certain breadcrumb links.
menu_configure in modules/menu/menu.admin.inc: Menu callback; Build the form presenting menu configuration options.
menu_help in modules/menu/menu.module: Implements hook_help().
menu_overview_form in modules/menu/menu.admin.inc: Form for editing an entire menu tree at once.
NodeTokenReplaceTestCase::testNodeTokenReplacement in modules/node/node.test: Creates a node, then tests the tokens generated from it.
NodeTypeTestCase::testNodeTypeEditing in modules/node/node.test: Test editing a node type using the UI.
node_feed in modules/node/node.module: Generates and prints an RSS feed.
node_help in modules/node/node.module: Implements hook_help().
node_overview_types in modules/node/content_types.inc: Displays the content type admin overview page.
node_page_view in modules/node/node.module: Menu callback; view a single node.
node_search_execute in modules/node/node.module: Implements hook_search_execute().
node_tokens in modules/node/node.tokens.inc: Implements hook_tokens().
number_help in modules/field/modules/number/number.module: Implements hook_help().
OpenIDFunctionalTestCase::addRedirectedIdentity in modules/openid/openid.test: Add OpenID identity, changed by the following redirects, to user's profile.
OpenIDFunctionalTestCase::testBlockedUserLogin in modules/openid/openid.test: Test that a blocked user cannot log in.
OpenIDFunctionalTestCase::testDelete in modules/openid/openid.test: Test deleting an OpenID identity from a user's profile.
OpenIDFunctionalTestCase::testDiscovery in modules/openid/openid.test: Test discovery of OpenID Provider Endpoint via Yadis and HTML.
OpenIDFunctionalTestCase::testLogin in modules/openid/openid.test: Test login using OpenID.
OpenIDFunctionalTestCase::testLoginMaintenanceMode in modules/openid/openid.test: Test login using OpenID during maintenance mode.
OpenIDFunctionalTestCase::testSignatureValidation in modules/openid/openid.test: Tests that openid.signed is verified.
OpenIDInvalidIdentifierTransitionTestCase::testStrippedFragmentAccountAutoUpdateSreg in modules/openid/openid.test: Test OpenID auto transition with e-mail.
OpenIDInvalidIdentifierTransitionTestCase::testStrippedFragmentAccountEmailMismatch in modules/openid/openid.test: Test OpenID transition with e-mail mismatch.
OpenIDRegistrationTestCase::testRegisterUserWithAXButNoSREG in modules/openid/openid.test: Test OpenID auto-registration with a provider that supplies AX information, but no SREG.
OpenIDRegistrationTestCase::testRegisterUserWithEmailVerification in modules/openid/openid.test: Test OpenID auto-registration with e-mail verification enabled.
OpenIDRegistrationTestCase::testRegisterUserWithInvalidSreg in modules/openid/openid.test: Test OpenID auto-registration with a provider that supplies invalid SREG information (a username that is already taken, and no e-mail address).
OpenIDRegistrationTestCase::testRegisterUserWithoutEmailVerification in modules/openid/openid.test: Test OpenID auto-registration with e-mail verification disabled.
OpenIDRegistrationTestCase::testRegisterUserWithoutSreg in modules/openid/openid.test: Test OpenID auto-registration with a provider that does not supply SREG information (i.e. no username or e-mail address).
openid_authentication in modules/openid/openid.module: Authenticate a user or attempt registration.
openid_login_validate in modules/openid/openid.module: Login form _validate hook
openid_test_html_openid1 in modules/openid/tests/openid_test.module: Menu callback; regular HTML page with OpenID 1.0 <link> element.
openid_test_html_openid2 in modules/openid/tests/openid_test.module: Menu callback; regular HTML page with OpenID 2.0 <link> element.
openid_test_redirect in modules/openid/tests/openid_test.module: Menu callback; redirect during Normalization/Discovery.
openid_test_yadis_http_equiv in modules/openid/tests/openid_test.module: Menu callback; regular HTML page with <meta> element.
openid_test_yadis_xrds in modules/openid/tests/openid_test.module: Menu callback; XRDS document that references the OP Endpoint URL.
openid_test_yadis_x_xrds_location in modules/openid/tests/openid_test.module: Menu callback; regular HTML page with an X-XRDS-Location HTTP header.
openid_user_add_submit in modules/openid/openid.pages.inc
options_help in modules/field/modules/options/options.module: Implements hook_help().
overlay_close_dialog in modules/overlay/overlay.module: Callback to request that the overlay close as soon as the page is displayed.
PageEditTestCase::testPageEdit in modules/node/node.test: Check node edit functionality.
PathLanguageTestCase::testAliasTranslation in modules/path/path.test: Test alias functionality through the admin interfaces.
path_admin_form in modules/path/path.admin.inc: Return a form for editing or creating an individual URL alias.
path_admin_overview in modules/path/path.admin.inc: Return a listing of all defined URL aliases.
path_help in modules/path/path.module: Implements hook_help().
php_enable in modules/php/php.install: Implements hook_enable().
php_help in modules/php/php.module: Implements hook_help().
poll_help in modules/poll/poll.module: Implements hook_help().
ProfileBlockTestCase::testAuthorInformationBlock in modules/profile/profile.test
ProfileTestAutocomplete::testAutocomplete in modules/profile/profile.test: Tests profile field autocompletion and access.
profile_block_configure in modules/profile/profile.module: Implements hook_block_configure().
profile_field_delete in modules/profile/profile.admin.inc: Menu callback; deletes a field from all user profiles.
profile_help in modules/profile/profile.module: Implements hook_help().
RdfCommentAttributesTestCase::testCommentReplyOfRdfaMarkup in modules/rdf/rdf.test: Test RDF comment replies.
RdfCommentAttributesTestCase::testNumberOfCommentsRdfaMarkup in modules/rdf/rdf.test: Tests the presence of the RDFa markup for the number of comments.
RdfMappingDefinitionTestCase::testAttributesInMarkup1 in modules/rdf/rdf.test: Create a node of type blog and test whether the RDF mapping defined for this node type in rdf_test.module is used in the node page.
RdfMappingDefinitionTestCase::testAttributesInMarkup2 in modules/rdf/rdf.test: Create a content type and a node of type test_bundle_hook_install and test whether the RDF mapping defined in rdf_test.install is used.
RdfMappingDefinitionTestCase::testAttributesInMarkup3 in modules/rdf/rdf.test: Create a random content type and node and ensure the default mapping for node is used.
RdfMappingDefinitionTestCase::testTaxonomyTermRdfaAttributes in modules/rdf/rdf.test: Creates a random term and ensures the right RDFa markup is used.
RdfMappingDefinitionTestCase::testUserAttributesInMarkup in modules/rdf/rdf.test: Create a random user and ensure the default mapping for user is used.
RdfRdfaMarkupTestCase::testAttributesInMarkupFile in modules/rdf/rdf.test: Ensure that file fields have the correct resource as the object in RDFa when displayed as a teaser.
RdfTrackerAttributesTestCase::_testBasicTrackerRdfaMarkup in modules/rdf/rdf.test: Helper function for testAttributesInTracker().
rdf_comment_load in modules/rdf/rdf.module: Implements hook_comment_load().
rdf_preprocess_comment in modules/rdf/rdf.module: Implements MODULE_preprocess_HOOK().
rdf_preprocess_taxonomy_term in modules/rdf/rdf.module: Implements MODULE_preprocess_HOOK().
rdf_preprocess_username in modules/rdf/rdf.module: Implements MODULE_preprocess_HOOK().
rdf_preprocess_user_profile in modules/rdf/rdf.module: Implements MODULE_preprocess_HOOK().
RemoveFeedItemTestCase::testRemoveFeedItem in modules/aggregator/aggregator.test: Test running "remove items" from the 'admin/config/services/aggregator' page.
SearchBlockTestCase::testBlock in modules/search/search.test: Test that the search block form works correctly.
SearchConfigSettingsForm::testSearchModuleDisabling in modules/search/search.test: Verify that you can disable individual search modules.
SearchLanguageTestCase::testLanguages in modules/search/search.test
search_admin_settings in modules/search/search.admin.inc: Menu callback: displays the search module settings page.
search_extra_type_search_execute in modules/search/tests/search_extra_type.module: Implements hook_search_execute().
search_form in modules/search/search.module: Builds a search form.
search_help in modules/search/search.module: Implements hook_help().
seven_node_add_list in themes/seven/template.php: Display the list of available node types for node creation.
shortcut_help in modules/shortcut/shortcut.module: Implements hook_help().
shortcut_set_switch_submit in modules/shortcut/shortcut.admin.inc: Submit handler for shortcut_set_switch().
SimpleTestBrowserTestCase::testGetAbsoluteUrl in modules/simpletest/simpletest.test: Test DrupalWebTestCase::getAbsoluteUrl().
simpletest_help in modules/simpletest/simpletest.module: Implements hook_help().
simpletest_requirements in modules/simpletest/simpletest.install: Implements hook_requirements().
simpletest_result_form in modules/simpletest/simpletest.pages.inc: Test results form for $test_id.
SiteMaintenanceTestCase::testSiteMaintenance in modules/system/system.test: Verify site maintenance mode functionality.
statistics_access_log in modules/statistics/statistics.admin.inc: Menu callback; Displays recent page accesses.
statistics_help in modules/statistics/statistics.module: Implements hook_help().
statistics_settings_form in modules/statistics/statistics.admin.inc: Form builder; Configure access logging.
system_admin_config_page in modules/system/system.admin.inc: Menu callback; Provide the administration overview page.
system_authorized_get_url in modules/system/system.module: Return the URL for the authorize.php script.
system_check_http_request in modules/system/system.module: Checks whether the server is capable of issuing HTTP requests.
system_clean_url_settings in modules/system/system.admin.inc: Form builder; Configure clean URL settings.
system_configure_date_formats_form in modules/system/system.admin.inc: Allow users to add additional date formats.
system_date_time_formats in modules/system/system.admin.inc: Displays the date format strings overview page.
system_date_time_settings in modules/system/system.admin.inc: Form builder; Configure the site date and time settings.
system_help in modules/system/system.module: Implements hook_help().
system_image_toolkit_settings in modules/system/system.admin.inc: Form builder; Configure site image toolkit usage.
system_modules in modules/system/system.admin.inc: Menu callback; provides module enable/disable interface.
system_modules_uninstall in modules/system/system.admin.inc: Builds a form of currently disabled modules.
system_performance_settings in modules/system/system.admin.inc: Form builder; Configure site performance settings.
system_permission in modules/system/system.module: Implements hook_permission().
system_requirements in modules/system/system.install: Test and report Drupal installation requirements.
system_site_information_settings in modules/system/system.admin.inc: Form builder; The general site information form.
system_site_maintenance_mode in modules/system/system.admin.inc: Form builder; Configure the site's maintenance status.
system_test_multiple_redirects in modules/simpletest/tests/system_test.module: Menu callback; sends a redirect header to itself until $count argument is 0.
system_test_redirect in modules/simpletest/tests/system_test.module
system_tokens in modules/system/system.tokens.inc: Implements hook_tokens().
system_update_7067 in modules/system/system.install: Grant administrators permission to view the administration theme.
system_user_login in modules/system/system.module: Implements hook_user_login().
TaxonomyTokenReplaceTestCase::testTaxonomyTokenReplacement in modules/taxonomy/taxonomy.test: Creates some terms and a node, then tests the tokens generated from them.
taxonomy_help in modules/taxonomy/taxonomy.module: Implements hook_help().
taxonomy_overview_terms in modules/taxonomy/taxonomy.admin.inc: Form builder for the taxonomy terms overview.
taxonomy_term_feed in modules/taxonomy/taxonomy.pages.inc: Generate the content feed for a taxonomy term.
taxonomy_tokens in modules/taxonomy/taxonomy.tokens.inc: Implements hook_tokens().
template_preprocess_aggregator_feed_source in modules/aggregator/aggregator.pages.inc: Processes variables for aggregator-feed-source.tpl.php.
template_preprocess_aggregator_item in modules/aggregator/aggregator.pages.inc: Processes variables for aggregator-item.tpl.php.
template_preprocess_book_navigation in modules/book/book.module: Process variables for book-navigation.tpl.php.
template_preprocess_forum_list in modules/forum/forum.module: Process variables to format a forum listing.
template_preprocess_forum_topic_list in modules/forum/forum.module: Preprocess variables to format the topic listing.
template_preprocess_maintenance_page in includes/theme.inc: The variables array generated here is a mirror of template_preprocess_page(). This preprocessor will run its course when theme_maintenance_page() is invoked.
template_preprocess_node in modules/node/node.module: Process variables for node.tpl.php
template_preprocess_page in includes/theme.inc: Preprocess variables for page.tpl.php
template_preprocess_taxonomy_term in modules/taxonomy/taxonomy.module: Process variables for taxonomy-term.tpl.php.
text_help in modules/field/modules/text/text.module: Implements hook_help().
theme_aggregator_page_rss in modules/aggregator/aggregator.pages.inc: Prints the RSS page for a feed.
theme_comment_post_forbidden in modules/comment/comment.module: Returns HTML for a "you can't post comments" notice.
theme_dashboard_disabled_blocks in modules/dashboard/dashboard.module: Returns HTML for a set of disabled blocks, for display in dashboard customization mode.
theme_image_style_list in modules/image/image.admin.inc: Returns HTML for the page containing the list of image styles.
theme_link in includes/theme.inc: Returns HTML for a link.
theme_node_add_list in modules/node/node.pages.inc: Returns HTML for a list of available node types for node creation.
theme_shortcut_set_customize in modules/shortcut/shortcut.admin.inc: Returns HTML for a shortcut set customization form.
theme_taxonomy_overview_vocabularies in modules/taxonomy/taxonomy.admin.inc: Returns HTML for the vocabulary overview form as a sortable list of vocabularies.
theme_textfield in includes/form.inc: Returns HTML for a textfield form element.
TokenReplaceTestCase::testSystemSiteTokenReplacement in modules/system/system.test: Tests the generation of all system site information tokens.
toolbar_help in modules/toolbar/toolbar.module: Implements hook_help().
tracker_help in modules/tracker/tracker.module: Implements hook_help().
tracker_page in modules/tracker/tracker.pages.inc: Menu callback; prints a listing of active nodes on the site.
TranslationTestCase::addLanguage in modules/translation/translation.test: Install a the specified language if it has not been already. Otherwise make sure that the language is enabled.
TranslationTestCase::assertLanguageSwitchLinks in modules/translation/translation.test: Check that the specified language switch links are found/not found.
translation_form_node_type_form_alter in modules/translation/translation.module: Implements hook_form_FORM_ID_alter().
translation_help in modules/translation/translation.module: Implements hook_help().
TriggerActionTestCase::generateTokenExpandedComparison in modules/trigger/trigger.test: Generates a comparison message to match the pre-token-replaced message.
trigger_assign_form in modules/trigger/trigger.admin.inc: Returns the form for assigning an action to a trigger.
trigger_help in modules/trigger/trigger.module: Implements hook_help().
UpdateCoreTestCase::testModulePageRegularUpdate in modules/update/update.test: Check the messages at admin/modules when missing an update.
UpdateCoreTestCase::testModulePageRunCron in modules/update/update.test: Check that running cron updates the list of available updates.
UpdateCoreTestCase::testModulePageSecurityUpdate in modules/update/update.test: Check the messages at admin/modules when missing a security update.
UpdateCoreTestCase::testModulePageUpToDate in modules/update/update.test: Check the messages at admin/modules when the site is up to date.
UpdateFeedTestCase::testUpdateFeed in modules/aggregator/aggregator.test: Create a feed and attempt to update it.
UpdateTestHelper::refreshUpdateStatus in modules/update/update.test: Refresh the update status based on the desired available update scenario.
UpdateTestUploadCase::testUpdateManagerCoreSecurityUpdateMessages in modules/update/update.test: Check the messages on Update manager pages when missing a security update.
update_help in modules/update/update.module: Implements hook_help().
update_mail in modules/update/update.module: Implements hook_mail().
update_manager_update_ready_form in modules/update/update.manager.inc: Build the form when the site is ready to update (after downloading).
update_settings in modules/update/update.settings.inc: Form builder for the update settings tab.
UpgradePathTaxonomyTestCase::testTaxonomyUpgrade in modules/simpletest/tests/upgrade/upgrade.taxonomy.test: Basic tests for the taxonomy upgrade.
UrlAlterFunctionalTest::assertUrlOutboundAlter in modules/simpletest/tests/path.test: Assert that an outbound path is altered to an expected value.
UserBlocksUnitTests::testUserLoginBlock in modules/user/user.test: Test the user login block.
UserLoginTestCase::assertFailedLogin in modules/user/user.test: Make an unsuccessful login attempt.
UserTokenReplaceTestCase::testUserTokenReplacement in modules/user/user.test: Creates a user, then tests the tokens generated from it.
user_account_form_validate in modules/user/user.module: Form validation handler for user_account_form().
user_admin_settings in modules/user/user.admin.inc: Form builder; Configure user settings for this site.
user_cancel_url in modules/user/user.module: Generates a URL to confirm an account cancellation request.
user_help in modules/user/user.module: Implement hook_help().
user_login_block in modules/user/user.module
user_login_final_validate in modules/user/user.module: The final validation handler on the login form.
user_pass_reset in modules/user/user.pages.inc: Menu callback; process one time login link and redirects to the user page on success.
user_pass_reset_url in modules/user/user.module: Generates a unique URL for a user to login and reset their password.
user_permission in modules/user/user.module: Implements hook_permission().
user_register_submit in modules/user/user.module: Submit handler for the user registration form.
user_search_execute in modules/user/user.module: Implements hook_search_execute().
user_tokens in modules/user/user.tokens.inc: Implements hook_tokens().
user_update_7017 in modules/user/user.install: Update email templates to use new tokens.
XMLRPCBasicTestCase::testListMethods in modules/simpletest/tests/xmlrpc.test: Ensure that a basic XML-RPC call with no parameters works.
XMLRPCBasicTestCase::testMethodSignature in modules/simpletest/tests/xmlrpc.test: Ensure that system.methodSignature returns an array of signatures.
XMLRPCMessagesTestCase::testAlterListMethods in modules/simpletest/tests/xmlrpc.test: Ensure that hook_xmlrpc_alter() can hide even builtin methods.
XMLRPCMessagesTestCase::testSizedMessages in modules/simpletest/tests/xmlrpc.test: Make sure that XML-RPC can transfer large messages.
XMLRPCValidator1IncTestCase::testValidator1 in modules/simpletest/tests/xmlrpc.test: Run validator1 tests.
_batch_progress_page_js in includes/batch.inc: Outputs a batch processing page with JavaScript support.
_batch_progress_page_nojs in includes/batch.inc: Outputs a batch processing page without JavaScript support.
_menu_site_is_offline in includes/menu.inc: Checks whether the site is in maintenance mode.
_openid_test_endpoint_authenticate in modules/openid/tests/openid_test.module: OpenID endpoint; handle "authenticate" requests.
_openid_user_login_form_alter in modules/openid/openid.module
_php_filter_tips in modules/php/php.module: Implements hook_filter_FILTER_tips().
_shortcut_link_form_elements in modules/shortcut/shortcut.admin.inc: Helper function for building a form for adding or editing shortcut links.
_update_message_text in modules/update/update.module: Helper function to return the appropriate message text when the site is out of date or missing a security update.
_update_no_data in modules/update/update.module: Prints a warning message when there is no data about available updates.

File

includes/common.inc, line 2099: Common functions that many Drupal modules will need to reference.

Code

<?php
function url($path = NULL, array $options = array()) {
  // Merge in defaults.
  $options += array(
    'fragment' => '', 
    'query' => array(), 
    'absolute' => FALSE, 
    'alias' => FALSE, 
    'prefix' => '',
  );

  if (!isset($options['external'])) {
    // Return an external link if $path contains an allowed absolute URL. Only
    // call the slow drupal_strip_dangerous_protocols() if $path contains a ':'
    // before any / ? or #. Note: we could use url_is_external($path) here, but
    // that would require another function call, and performance inside url() is
    // critical.
    $colonpos = strpos($path, ':');
    $options['external'] = ($colonpos !== FALSE && !preg_match('![/?#]!', substr($path, 0, $colonpos)) && drupal_strip_dangerous_protocols($path) == $path);
  }

  // Preserve the original path before altering or aliasing.
  $original_path = $path;

  // Allow other modules to alter the outbound URL and options.
  drupal_alter('url_outbound', $path, $options, $original_path);

  if (isset($options['fragment']) && $options['fragment'] !== '') {
    $options['fragment'] = '#' . $options['fragment'];
  }

  if ($options['external']) {
    // Split off the fragment.
    if (strpos($path, '#') !== FALSE) {
      list($path, $old_fragment) = explode('#', $path, 2);
      // If $options contains no fragment, take it over from the path.
      if (isset($old_fragment) && !$options['fragment']) {
        $options['fragment'] = '#' . $old_fragment;
      }
    }
    // Append the query.
    if ($options['query']) {
      $path .= (strpos($path, '?') !== FALSE ? '&' : '?') . drupal_http_build_query($options['query']);
    }
    if (isset($options['https']) && variable_get('https', FALSE)) {
      if ($options['https'] === TRUE) {
        $path = str_replace('http://', 'https://', $path);
      }
      elseif ($options['https'] === FALSE) {
        $path = str_replace('https://', 'http://', $path);
      }
    }
    // Reassemble.
    return $path . $options['fragment'];
  }

  global $base_url, $base_secure_url, $base_insecure_url;

  // The base_url might be rewritten from the language rewrite in domain mode.
  if (!isset($options['base_url'])) {
    if (isset($options['https']) && variable_get('https', FALSE)) {
      if ($options['https'] === TRUE) {
        $options['base_url'] = $base_secure_url;
        $options['absolute'] = TRUE;
      }
      elseif ($options['https'] === FALSE) {
        $options['base_url'] = $base_insecure_url;
        $options['absolute'] = TRUE;
      }
    }
    else {
      $options['base_url'] = $base_url;
    }
  }

  // The special path '<front>' links to the default front page.
  if ($path == '<front>') {
    $path = '';
  }
  elseif (!empty($path) && !$options['alias']) {
    $language = isset($options['language']) && isset($options['language']->language) ? $options['language']->language : '';
    $alias = drupal_get_path_alias($original_path, $language);
    if ($alias != $original_path) {
      $path = $alias;
    }
  }

  $base = $options['absolute'] ? $options['base_url'] . '/' : base_path();
  $prefix = empty($path) ? rtrim($options['prefix'], '/') : $options['prefix'];

  // With Clean URLs.
  if (!empty($GLOBALS['conf']['clean_url'])) {
    $path = drupal_encode_path($prefix . $path);
    if ($options['query']) {
      return $base . $path . '?' . drupal_http_build_query($options['query']) . $options['fragment'];
    }
    else {
      return $base . $path . $options['fragment'];
    }
  }
  // Without Clean URLs.
  else {
    $path = $prefix . $path;
    $query = array();
    if (!empty($path)) {
      $query['q'] = $path;
    }
    if ($options['query']) {
      // We do not use array_merge() here to prevent overriding $path via query
      // parameters.
      $query += $options['query'];
    }
    $query = $query ? ('?' . drupal_http_build_query($query)) : '';
    $script = isset($options['script']) ? $options['script'] : '';
    return $base . $script . $query . $options['fragment'];
  }
}
?>

Comments

Use function url: $account1 =

Posted by itqn2004 on January 11, 2011 at 3:45am

Use function url:

$account1 = user_load(array('uid' => $db->uid));		
		$fullname1 = trim($account1->profile_firstname ." " . $account1->profile_lastname);
		$url = url('admin/affiliate/'.$account1->uid.'/affiliate-dashboard', array('absolute' => TRUE));
		$link = '<a id="sticky" href="'.$url.'" rel="'.$url.'">'.$fullname1.'</a>';

Not the best example. Aside

Posted by Garrett Albright on May 10, 2011 at 12:40pm

Not the best example. Aside from using a URL for the "rel" parameter (wha?), your best bet when making a link is to use the l() function.

Do not use within hook_requirements()

Posted by pillarsdotnet on May 20, 2011 at 8:58pm

Calling the url() function within a hook_requirements() implementation results in a fatal error.

Issue reported here: http://drupal.org/node/1149580

https option ignored

Posted by berenddeboer on February 3, 2012 at 1:02am

It appears the https option is simply ignored. I.e. if you are in http mode, you cannot emit an https url, see http://drupal.org/node/932738