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:

view plain print about

<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>

<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:

	
	
			
			
			
				
				view plain
				
				
				copy to clipboard
				
				
				
				
				print
				
				
				about
				ColdFISH is developed by Jason Delmore.  Source code and license information available at coldfish.riaforge.org.  Version 3.1.1
				
			<!---
 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 (&#98;&#101;&#110;&#64;&#102;&#111;&#114;&#116;&#97;&#46;&#99;&#111;&#109;) 
 @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>
		<!---
 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>