CFLib.org – urlExists

urlExists(u)

Last updated January 3, 2006

Download UDF

author

Ben Forta
Send Email

Version: 1 | Requires: ColdFusion MX | Library: NetLib

Rated 0 time(s). Average Rating: 0

Description:
Checks to see if a particular URL actually exists.

Return Values:
Returns a boolean.

Example:

<cfset list = "http://www.cflib.org,http://www.dfkdhsfjksdfh.com,http://www.cflib.org/fooman.jsp">
<cfloop index="u" list="#list#">
<cfoutput>Does #u# exist? #urlExists(u)#<br /></cfoutput>
</cfloop>

Parameters:

Name	Description	Required
u	The URL to check.	Yes

Full UDF Source:

	
	<!---
 Checks to see if a particular URL actually exists.
 Gus made some changes to handle a unresolving domain.
 
 @param u      The URL to check. (Required)
 @return Returns a boolean. 
 @author Ben Forta (ben@forta.com) 
 @version 1, January 3, 2006 
--->
<cffunction name="urlExists" output="no" returntype="boolean">
    <!--- Accepts a URL --->
    <cfargument name="u" type="string" required="yes">

    <!--- Initialize result --->
    <cfset var result=true>

    <!--- Attempt to retrieve the URL --->
    <cfhttp url="#arguments.u#" resolveurl="no" throwonerror="no" />

    <!--- Check That a Status Code is Returned --->
    <cfif isDefined("cfhttp.responseheader.status_code")>
        <cfif cfhttp.responseheader.status_code EQ "404">
            <!--- If 404, return FALSE --->
            <cfset result=false>
        </cfif>
    <cfelse>
        <!--- No Status Code Returned --->
        <cfset result=false>
    </cfif>
    <cfreturn result>
</cffunction>