osCommerce安装指南
引言： osCommerce是自由软件社区最受欢迎的网络商店系统之一，海外和台湾地区都有大量的自愿者在进行开发和贡献，唯中国国内只有少量的和基于早期版本 osCommerce开发的简体中文版本的源代码公开，而且都缺少目前最流行的STS和AddImage功能。为此，我们发布了公开源代码的 osCommerce，希望更多的软件开发者、爱好者、企业的软件工作人员能更进一步了解自由软件的文化，甚至能利用自由软件来提高生产效益。
目录： osCommerce安装指南 1 osCommerce简介 2 一、osCommerce是什么？ 2 二、osCommerce有哪些功能？ 2 三、osCommerce大中华版有哪些额外功能？ 3 四、哪里能看到osCommerce的Demo呢？ 3 五、怎样才能获得osCommerce呢？ 4 osCommerce大中华版安装过程 4 一、系统要求 4 二、快速安装（使用安装向导） 5 三、手动安装 9 四、升级安装 10 五、STS的模板设置 11 常见问题解答 15 一、前台设置问题 15 二、后台设置问题 16 三、服务器设置相关问题 17
osCommerce简介一、osCommerce是什么？ osCommerce 为 Open Source e-Commerce 的缩写，就字面意义看，很清楚可以知道它是一个架构在开放源代码的购物系统。 osCommerce 融入了开放源代码解决方案(open source solutions)，使用强大的 PHP 网页描述语言、稳定的 Apache 网页主机(web server)以及快速的MySQL数据库主机(database server)为基础，提供一个完全免费和开放的购物开发平台。虽然如此， osCommerce 的运作却没有太多限制或特殊需求，它可以安装在任何 PHP3、PHP4 的网页主机，或是任何支持 PHP 和 MySQL 的环境，其中包括 Linux、Solaris、BSD、Microsoft Windows 等环境，并且让商店拥有人以用最少的人力及最低的成本设立、营运以及维护自己的线上购物商店。
二、osCommerce有哪些功能？标准功能 PHP3/PHP4 兼容安装容易、可立即使用模块化多国语系：英文、德文、西班牙文以及世界各国自制的语系。
前台客户会员功能客户通讯簿订单纪录提供暂存(未登入时)和永久(登入时)的购物车产品及制造商搜寻功能提供客户评论商品电子邮件通知功能（可用于交易处理，客户沟通及发广告信,期刊）简洁的结帐手续可使用 SSL 安全网上交易可显示每一商品目录内的商品数量支持多国货币及自动汇率计算最受欢迎产品统计可以显示其它客户购买商品(建议购买清单) 等等
后台每日24小时，随时登入管理产品目录随时浏览交易及详细客户资料友善的操作接口可新增/编辑/移除 商品分类、商品、制造商、客户和商品评论无限层的产品目录结构多项商品和客户统计资料动态商品属性提供税区、税别及税率设定可远程编辑数据库内之设定参数值前后台可分开置于不同主机提供付款及运送模块做为跨国商店时，可连结到 oanda.com 交换汇率可自订商品排序及列表方式提供可控制的备份工具 等等 osCommerce安装过程一、系统要求这里我们以osCommerce大中华版2006为例（含简/繁体中文/英文/日文，有AddImage，STS和MaxCapture的两套标准STS模板），介绍osCommerce大中华版的安装过程。 osCommerce大中华版默认设置是以GNU/Linux或Unix系统的路径及权限为标准的，当然，您只需稍作修改，也可以把它安装到Windows+PHP+Apache或IIS的环境中。如果您想在Linux或Unix主机上安装osCommerce大中华版，请必须确认您的Apache（httpd）、PHP、Perl和MySQL都已经安装并运行起来了。至于这几个软件的安装方法，您可以很容易在网上找到。
二、快速安装（使用安装向导）快速安装是针对第一次使用osCommerce大中华版的用户而设，用户可以通过简单的步骤完成安装过程，而无需过多地对主机进行设置。 1、解压文件包 A) 直接在Linux主机上解压：运行命令： unzip OSC-2.2ms2-GreaterChina2006.zip （对于zip文件）或 tar -xzf OSC-2.2ms2-GreaterChina2006.tar.gz （对于tar.gz文件） B) 在windows下解压，请使用最新版本的winzip或winrar.
2、拷贝目录catalog到您的站点WWW根目录下 A) Linux下： cd OSC-2.2ms2-GreaterChina2006 cp -R catalog /usr/local/apache/htdocs/ （高级话题：在这个例子里，我们以WWW的站点根目录/usr/local/apache/htdocs/为例，但用户的WWW站点根目录由您的主机实际设置情况所决定，具体请查阅Apache的设置文件/etc/httpd/httpd.conf，或咨询您的主机管理人员；如果您使用的虚拟主机无法使用命令行操作，请先把文件在Windows下解压，然后再用FTP上传到您的站点WWW根目录下。） B) Windows下：通过FTP把catalog目录上传到您的站点WWW根目录下。
3、修改文件和目录访问权限在Linux系统环境下，必须正确设置部分文件和目录权限，以便正确进行安装。当然，如果您忘记预先进行设置，在安装过程中我们的程序还是会提醒您的。把以下文件的权限设为666： ./catalog/include/configure.php ./catalog/admin/include/configure.php 把以下文件的权限设为777，以用于写入文件： ./catalog/admin/backups/. ./catalog/images 如果你把osCommerce大中华版安装于MS Windows上，则无须做此步。
以命令行方式修改： cd /usr/local/apache/htdocs/ chmod 666 ./catalog/include/configure.php chmod 666 ./catalog/admin/include/configure.php chmod 777 ./catalog/admin/backups/ chmod 777 ./catalog/images 此步骤也可以用FTP软件完成，Linux上的权限设置问题，请参阅网上相关的文章。
4、MySQL的设置您必须在运行安装向导程序之前在MySQL中创建一个空的数据库，名字不限，可以设置为“OSC_GreaterChina”或其他。如果您对命令行下的MySQL管理不熟悉，建议您在Linux服务器上安装一个MySQL的网页管理界面工具phpMyAdmin，使用十分简单方便，详细使用和安装方式请联系您的主机管理员或参阅。
5、运行安装向导程序 A) 打开网页浏览器，并输入如下地址： site]/catalog/install “[your site]”以您主机的真实域名替换，例如localhost, 请注意，安装向导界面将统一使用简体中文版本。您将见到如下的安装欢迎页面： B) 点击Install图标，进行第一次安装（请注意，旧版本的osCommerce大中华版标准版本提供的“升级向导”功能，在osCommerce大中华版2006中将不再提供，原因是由于大中华版2006加入了STS功能并修改大量的页面，除部分数据库结构外，其他均与旧版本有较大区别，直接使用升级向导升级可能会导致小部分页面出错，所以只提供了第一次安装模式。但如果使用清洁的第一次安装，均不会出现任何问题。）为免安装出错，请先备份旧系统，并把旧系统文件夹改名。如果使用osCommerce大中华版2006升级旧版本的osCommerce大中华版STS-base或STS-MAX，也应先进行备份再作覆盖安装。 C) 选择“导入数据库”和“自动设定”两项，并点击“继续”： D) 根据您的主机实际情况，或根据主机管理员为您做的数据库设定资料，填写对应的数据库主机名、数据库访问用户名、数据库访问密码、数据库名称等项目。如果您的主机非独立的主机，最好不选择保持连接，因为这样会使主机的负荷增加。Session（对话，PHP中保持用户登陆状态的信息）可以选择保存在数据库上（如使用Windows主机必须选择保存在数据库上）： E) 提示即将自动导入对应的MySQL数据库表（所有osCommerce大中华版2006已提供正确的数据库表，在./catalog/install/下面，安装程式已预设该路径），请确认： F) 导入成功： G) 确认安装目录资料，此次将写入另一个配置文件，请在此步确认是否使用SSL（安全的网页信息加密，但您的主机必须已安装SSL。使用SSL后，访问您的网上购物站点必须使用https）： H) 再次确认数据库资料： 如果您的./catalog/include/configure.php和./catalog/admin/include/configure.php读写权限设置不当，您将获得一个警告页面： 按照提示修改读写权限后，按“重试”即可安装成功： I) 点击“前台”将看到已经安装后的网络商店主页，点击右下角的中国国旗标志，可切换到简体中文界面；点击香港特区区旗，可得到繁体中文界面；英国国旗则是英文界面；日本国旗就是日文界面。页面上的红色区域是提示您./catalog/include/configure.php和./catalog /admin/include/configure.php读写权限需改回644的只读模式，修改正确后红色区域将自动消失。 J) 点击“后台管理工具”将进入管理界面，由于osCommerce大中华版增加了后台管理密码保护功能，这里需要有管理员密码才能登陆。如果您是第一次使用后台管理模式，管理界面将根据您的浏览器语言版本自动选择语言，您有可能见到英文版本的后台登陆界面。不用担心，当您成功登陆并选择后台管理语言后，以后的登陆界面都会按照您的习惯自动进行修正。 osCommerce大中华版2006默认的管理员邮箱是，管理员密码是admin。在修改管理员邮箱前，请不要使用忘记密码功能，否则您的新密码将寄到去了：）后台管理的功能十分强大，请用户在您的网络购物站点投入正式使用前必须要做测试，以免出现操作错误。由于我们预设的部分数据库资料是以简体中文为标准，所以如果您正在使用英文、繁体中文或日文的后台界面，部分页面可能会出错或乱码。
K) 如果您获得的是osCommerce大中华版2006（或STS-base，或STS-MAX），简单模板系统将在安装向导过程中自动安装成功。您会获得一个预设的页面模板：./catalog/includes/sts_template.html。更多关于STS的知识请见以下文件：. /catalog/includes/sts_templates/README.txt。对于STS的进一步修改和设定，我们将在后文中介绍。
三、手动安装手动安装适合高级用户使用，便于开发用户进行测试。 1、创建数据库并导入数据库表用户可根据实际情况，直接使用MySQL命令或phpMyadmin进行操作。命令行下的操作如下，例如我们要建立的数据库名字为OSC_CreaterChina： mysqladmin create OSC_CreaterChina mysql OSC_GreaterChina < ./install/OSC-2.2ms2-GreaterChina-AddImages.sql 如果您需要检查数据表是否成功被导入，您可以使用mysqlshow把它们给列出来： mysqlshow OSC_CreaterChina
2、修改配置文件手工修改以下两个配置文件，具体的设置方式在文件里面有注释说明： ./catalog/includes/configure.php ./ catalog/admin/includes/configure.php
四、升级安装 1、从osCommerce2.0以前版本升级到osCommerce大中华版标准版本请直接使用osCommerce大中华版标准版本安装向导中的升级功能完成，该升级向导为英文界面。（建议：为避免升级过程中出错，用户应在升级前备份原始版本的文件和数据库）
2、从osCommerce大中华版标准版本升级到osCommerce大中华版STS-base版本 A) 从osCommerce大中华版STS-base的./catalog/includes/目录复制以下文件，并替换原来的标准版在./catalog /includes/下的文件（请注意，别错误地把文件拷进./catalog/admin/includes/）： application_top.php header.php column_left.php column_right.php footer.php application_bottom.php sts_start_capture.php sts_stop_capture.php sts_restart_capture.php sts_display_output.php sts_user_code.php sts_template.html
B) 在标准版的./catalog/includes/configure.php文件中的最后一行“?>”前加入以下程序： // STS: ADD: Define Simple Template System files define(’STS_START_CAPTURE’, DIR_WS_INCLUDES . ’sts_start_capture.php’); define(’STS_STOP_CAPTURE’, DIR_WS_INCLUDES . ’sts_stop_capture.php’); define(’STS_RESTART_CAPTURE’, DIR_WS_INCLUDES . ’sts_restart_capture.php’); define(’STS_TEMPLATE_DIR’, DIR_WS_INCLUDES . ’sts_templates/’); define(’STS_DEFAULT_TEMPLATE’, DIR_WS_INCLUDES . ’sts_template.html’); define(’STS_DISPLAY_OUTPUT’, DIR_WS_INCLUDES . ’sts_display_output.php’); define(’STS_USER_CODE’, DIR_WS_INCLUDES . ’sts_user_code.php’); define(’STS_PRODUCT_INFO’, DIR_WS_INCLUDES . ’sts_product_info.php’); // STS: EOADD
3、从osCommerce大中华版STS-base版本升级到osCommerce大中华版STS-MAX版本 A) 拷贝STS-MAX版本的./catalog/stylesheet.css文件，并覆盖STS-base的对应文件。 B) 从STS-MAX的./catalog/includes/目录复制以下文件，并覆盖STS-base的对应文件： footer.php header.php sts_display_output.php application_top.php sts_template.html
C) 复制并替换./catalog/includes/languages/english/images/整个文件夹。 D) 复制并替换./catalog/includes/classes/boxes.php文件。 E) 复制并替换./catalog/includes/boxes/categories.php文件。 F) 复制并替换./catalog/images/整个文件夹。
4、从osCommerce大中华版的各种版本升级到osCommerce大中华版2006 备份原系统数据和页面文件后进行覆盖安装，同时在后台启用日文语言包及PayPal IPN。
五、STS的模板设置 osCommerce大中华版2006，以及以往的STS-base版本和STS-MAX版本均集成了简单模版系统（STS），这不但免除用户自行安装 STS时出现的困难和问题，同时也使开发者和高级用户快速修改整个站点风格或开发网页模板成为可能。原版的英文说明书在./catalog /includes/sts_templates/README.txt
1、STS的作用 STS的主要功能是使站点管理人员能够通过修改简单的模板文件，而对osCommerce的外观进行高质量的修改。使用STS后，我们只需要修改模板文件上的placeholders（占位符），就能使站点产生与别人不同的外观。如配合图片使用，那效果将更加出色。例如，您需要修改购物车显示位置，只需要移动 “$cartbox” ；当您要把主页上的消息放在醒目的位置，只需要移动“$content”，等等。安装好osCommerce大中华版的STS-base版本和STS-MAX版本后，您会看到STS-base是STS的默认配置状态，页面上除了用 STS重新做排版外，未做任何人工修饰，这利于二次开发；而STS-MAX以及osCommerce大中华版2006就是经过细心修饰的STS产品，便于用户立即投入使用。 （STS-base有很明显的表格组成，便于开发者或高级用户修改）（STS-MAX使用修改过的模板，便于立即投入使用和参考开发）
2、STS的模板 STS能支持多重模板，功能如下： A) 默认的站点模板./catalog/includes/sts_template.html B) 默认的类别（category）模板：. /catalog/includes/sts_templates/index.php.html C) 主目录页面（cPath=0）的模板：. /catalog/includes/sts_templates/index.php_0.html D) 其他目录页面（cPath=XX_YY）的模板：. /catalog/includes/sts_templates/index.php_XX-YY.html (这里的XX_YY是指cPath=XX_YY，其数据根据目录的网址URL确定)。 E) 商品信息模板./catalog/includes/sts_templates/product_info.php.html，您可以利用 product_info模板的变量（将在下文列出）来对您的product_info页面进行排版。但osCommerce大中华版的用户需要注意，由于AddImage（多图显示功能）的product_info页面与STS的product_info模板变量不兼容，使用product_info模板后将无法使用AddImage。另外，STS-MAX和STS-base目前只使用了sts_template.html，其他模板用户可以自行编写或在网上寻找。
3、最简单的修改STS方式只需修改./catalog/includes/sts_template.html文件，定制各表格和位置分布即可得到不同的显示效果，配合stylesheet（CSS）使用会更加出色。
4、使用多重模板文件您可以根据被执行的script（PHP文件）来创建一些多重模板文件。例如，我们为“index.php”定制一个模板应为：./catalog /includes/sts_templates/index.php.html。如果定制的模板文件不是为当前的script所定义的，它将以 STS_DEFAULT_TEMPLATE文件替代。
5、使用多重目录模板您可以为单个或全部目录定制模板，如果选择适当的文件，请参阅“五-3”。
6、使用product_info模板您可以为您的产品信息页面定制$CONTENT区域的模板，设计出漂亮排版，只需要创建文件./catalog/includes /sts_templates/product_info.php.html，我们为您准备了一个例子在./catalog/includes /sts_templates/里面。但请您注意，使用product_info模板后将无法使用AddImage（请参阅“五-3”）。
7、支持的模板标签（TAGS） $headcontent: 把这行加入到您的源代码的区域，它能插入动态的网页头内容（the dynamic head content）和javascript。（如果需要在页头加一些注释而不显示在页面上，可以这样写：；但不要把放入页头，否则它会变成$headcontent变量的一部分； $cataloglogo: logo标志和链接； $urlcataloglogo: $cataloglogo所对应的URL； $myaccountlogo: “我的帐号”图片和链接； $urlmyaccountlogo: “我的帐号”的功能链接； $cartlogo: “购物车”图片和链接； $urlcartlogo: “购物车”的功能链接； $checkoutlogo: “结算” 图片和链接； $urlcheckoutlogo: “结算”的功能链接； $breadcrumbs: 页顶的\”Top > Catalog > whatever…”路径显示文字和链接； $myaccount: 文字格式的“我的帐号”和链接. 如果已经登陆，将会变成\”Logoff”； $urlmyaccount: “我的帐号”的URL； $logoff: “Logoff”的文字和链接； $urllogoff: “Logoff”的URL； $myaccountlogoff: 如果已经登陆，显示“我的帐号 | Logoff”，如果未登陆，则显示“我的帐号”； $cartcontents: “购物车内容”文字显示； $urlcartcontents: “购物车内容”的URL； $checkout: 文字格式的“结算”； $urlcheckout: “结算”的URL； $categorybox: 显示类别的方格； $manufacturerbox: 显示厂商的方格； $whatsnewbox: 显示新品上架的方格； $searchbox: 显示搜索工具的方格； $informationbox: 显示信息的方格； $cartbox: 显示购物车的方格； $maninfobox: 显示厂商信息的方格 (如果为空就不显示在页面上)； $orderhistorybox: 定单历史的方格 (如果为空就不显示在页面上，例如用户未登陆)； $bestsellersbox: 显示畅销商品的方格； $specialfriendbox: 其他专门的方格或“推荐给朋友”方格 (根据页面视图而定)； $reviewsbox: 显示评论的方格； $languagebox: 显示语言选择的方格； $currenciesbox: 显示流通货币选择的方格； $content: 页面的主内容 (在页面中间)； $date: 当前时间； $numrequests: 显示从建站起的浏览次数； $counter: 页面浏览计数器； $footer: footer.php的页脚输出； $banner: footer.php的banner广告条； $sid: Session ID的string 以\”SessionIdVarName=WhateverTheSessionIdIs”格式显示； $urlcat_Category_Name: 商品目录的URL链接，商品目录名中的空格必须以下划线替代。例如，目录“Video Cards”的链接您所使用模板变量是 $urlcat_Video_cards，由于变量名不分大小写，您可以随便使用大写或小写字母； $urlcat_x_y_z:使用cPath string把URL和目录链接起来； $cat_Category_Name: 与$urlcat_Category_Name一样； $cat_x_y_z: 与$urlcat_x_y_z一样； $catmenu: 一个下拉型的目录菜单 (使用sts_user_code.php进行定义)。
8、支持的PRODUCT_INFO模板标签如果你使用了Product_Info模板，这些标签能用来代替. /catalog/includes/sts_templates/product_info.php.html文件中的$content变量。 $startform: 目录中的第一个项目； $endform: 目录中的最后一个项目； $productname: 商品名字； $productmodel: 商品型号或空格； $productdesc: 商品描述； $imagesmall: 商品的缩图，大小由后台管理定制； $imagelarge: 商品的大图（图片真实尺寸）； $optionheader: “可用到的选项”的文字，如果没有设置则留空； $optionames: 选项列表，名字，以换行符分隔 (” “)，如果没有设置则留空； $optionchoices: 选项列表下拉菜单，以换行符分隔，如果没有设置则留空； $moreinfolabel: TEXT_MORE_INFORMATION的值，链接到一个详细介绍页面； $moreinfourl: 更多信息的URL； $productdatelabel: 包含上架日期和可用日期等信息的指定语言； $productdate: 上架日期或可用日期； $reviews: 对商品的评论数目； $reviewsbutton: 发表评论的按钮； $reviewsurl: 发表评论的URL；
9、页头LOGO的修改 A) 对于osCommerce大中华版标准版本，logo文件于./catalog/images/oscommerce.gif，文字描述和图片地址在. /catalog/includes/header.php文件中，修改下面粗体字部分即可，“oscommerce.gif”是文件名，“osCommerce”是文字描述：
