Difference between revisions of "Lucee"

From Hostek.com Wiki
Jump to: navigation, search
m (How do I create a datasource within Lucee?)
(How do I access my Lucee Web Administator page?)
Line 21: Line 21:
 
==How do I access my Lucee Web Administator page?==
 
==How do I access my Lucee Web Administator page?==
 
The preferred way to access your site's Lucee Web Administrator is by clicking the '''''Web Administrator''''' link within your control panel. Alternatively, you may access it by appending '''''/lucee/admin/web.cfm''''' to the end of your site's domain name or testing URL.
 
The preferred way to access your site's Lucee Web Administrator is by clicking the '''''Web Administrator''''' link within your control panel. Alternatively, you may access it by appending '''''/lucee/admin/web.cfm''''' to the end of your site's domain name or testing URL.
 +
===I'm redirected to another page on my site when accessing the Lucee Web Administrator===
 +
If your site uses rewrite rules to make your site's links search-engine-friendly, then you'll need to make a small adjustment to your rewrite rules. Add the following line to your site's ''.htacess'' file to allow your Lucee Web Administrator to load properly:
 +
<syntaxhighlight lang="apache">
 +
RewriteEngine On
 +
 +
RewriteCond %{REQUEST_URI} !^.*/(lucee)($|/.*$) [NC]
 +
RewriteRule ^(.*)$ - [NC,L]
 +
</syntaxhighlight>
 +
 +
That code will tell the rewrite engine to ignore requests that contain the word ''lucee''. If your site already has a similar ''RewriteCond'' in its .htacess file ''(common with CF Wheels or ColdBox)'', then just add ''lucee'' to the list of URIs to bypass.
  
 
==How do I create a datasource within Lucee?==
 
==How do I create a datasource within Lucee?==
 
You may create Lucee datasources (DSNs) either withing your site's Lucee Web Administrator or within the site's Application.cfc. More info on creating Lucee datasources is in this Lucee Cookbook entry: [https://bitbucket.org/lucee/lucee/wiki/Cookbook_Datasource_Define_Datasource How to define a Datasource]
 
You may create Lucee datasources (DSNs) either withing your site's Lucee Web Administrator or within the site's Application.cfc. More info on creating Lucee datasources is in this Lucee Cookbook entry: [https://bitbucket.org/lucee/lucee/wiki/Cookbook_Datasource_Define_Datasource How to define a Datasource]

Revision as of 21:41, 24 February 2015

Luceelogo.png

Lucee is an open-source CFML engine and the successor of Railo. We proudly support Lucee in our environment, and more info about its background and usage is below.

Background

The Lucee project was forked from Railo 4.2 in January 2015 and is owned by Lucee Association Switzerland. Though development on Railo has halted, Lucee will eventually inherit the enhancements planned for Railo 5. Currently Lucee operates the same as the latest available version of Railo, so you can migrate your Railo codebase to it without any surprises.

See these blogs for more info on the switch from Railo to Lucee:

Usage / Resources

For information about Lucee please reference the Lucee wiki. Specifically, the Lucee Cookbook has lots of good info about getting started.

If you're new to CFML in general, the following resources will help you get learn the basics:

How do I access my Lucee Web Administator page?

The preferred way to access your site's Lucee Web Administrator is by clicking the Web Administrator link within your control panel. Alternatively, you may access it by appending /lucee/admin/web.cfm to the end of your site's domain name or testing URL.

I'm redirected to another page on my site when accessing the Lucee Web Administrator

If your site uses rewrite rules to make your site's links search-engine-friendly, then you'll need to make a small adjustment to your rewrite rules. Add the following line to your site's .htacess file to allow your Lucee Web Administrator to load properly:

RewriteEngine On
 
RewriteCond %{REQUEST_URI} !^.*/(lucee)($|/.*$) [NC]
RewriteRule ^(.*)$ - [NC,L]

That code will tell the rewrite engine to ignore requests that contain the word lucee. If your site already has a similar RewriteCond in its .htacess file (common with CF Wheels or ColdBox), then just add lucee to the list of URIs to bypass.

How do I create a datasource within Lucee?

You may create Lucee datasources (DSNs) either withing your site's Lucee Web Administrator or within the site's Application.cfc. More info on creating Lucee datasources is in this Lucee Cookbook entry: How to define a Datasource