似乎他们没有任何文档,除了在他们的官方论坛上有一些api调用之外。我有Zend框架和CodeIgniter框架的经验。OpenCart的任何高手都可以向我推荐学习它的最佳方法,并在最短的时间内进行掌握吗?我必须尽快做一个大项目。
似乎他们没有任何文档,除了在他们的官方论坛上有一些api调用之外。我有Zend框架和CodeIgniter框架的经验。OpenCart的任何高手都可以向我推荐学习它的最佳方法,并在最短的时间内进行掌握吗?我必须尽快做一个大项目。
Answers:
本指南是为已经熟悉PHP,OOP和MVC架构的开发人员编写的
在下面的内容中,您将看到购物车目录侧的示例。除了在相关部分中提到的视图外,管理方在功能上是相同的
所有库功能都可以通过使用,,模型和视图通过Controller访问$this->library_name
。所有这些都可以在/system/library/
文件夹中找到。例如,要访问当前购物车的产品,您将需要使用Cart
类,该类/system/library/cart.php
可以使用来访问$this->cart->getProducts()
常用物品
customer.php
-客户相关功能user.php
-管理员用户相关功能cart.php
-购物车相关功能config.php
-所有设置都从这里加载url.php
-URL生成功能OpenCart的框架依靠route=aaa/bbb/ccc
查询字符串参数中的来知道要加载的内容,并且是查找需要为每个页面编辑的文件的基础功能。实际上,大多数路由仅使用aaa/bbb
,应该将其视为两个部分,但是其中一些包含三个部分aaa/bbb/ccc
。第一部分aaa
通常与通用文件夹(如控制器或模板文件夹)中的文件夹有关。第二部分通常与文件名有关,没有相关.php
或.tpl
扩展名。第三部分在下面的“了解控制器”部分中进行了说明
语言存储在子/catalog/language/
文件夹的your-language
文件夹中。其中,跨页面使用的常规文本值存储在your-language.php
文件夹内的文件中,因此对于目录侧的英语,您可以在中找到这些值catalog/language/english/english.php
。对于特定的页面文本,您将需要该页面的文本route
(通常是这种情况,但并非总是如此,因为您可以指定所需的任何语言文件)。例如,搜索页面具有路线product/search
,因此该页面的特定于语言的文本可以在中找到catalog/language/english/product/search.php
(请注意,文件名和子文件夹与路径匹配,后跟.php
。
要在控制器中加载语言,请使用
$this->language->load('product/search');
然后,您可以使用语言库功能get
来检索特定的语言文本,例如
$some_variable = $this->language->get('heading_title');
语言变量是使用特殊变量在语言文件中分配的,该特殊变量$_
是键和文本值的数组。在您中,/catalog/language/english/product/search.php
您应该找到类似的内容
$_['heading_title'] = 'Search';
全局语言文件english/english.php
中的值将自动加载,并且无需使用该$this->language->load
方法即可使用
控制器是基于加载的route
,很容易理解。控制器位于/catalog/controller/
文件夹中。从上一个示例继续,“搜索控制器”页面/product/search.php
位于此文件夹中。再次注意,使用了跟随的路线.php
。
打开控制器文件,您将看到Pascal Case类名扩展了Controller
名为的类ControllerProductSearch
。这再次是特定于路由的,Controller
其后是子文件夹名称和文件名,而后缀大写。实际不需要大写,但为了易于阅读,建议使用大写。值得注意的是,类名除了字母和数字外,不从子文件夹和文件名中获取任何值。下划线被删除。
在类中是方法。声明的类中的方法public
可通过路由访问- private
不能。默认情况下,使用标准的两部分路由(aaa/bbb
上述),将index()
调用默认方法。如果使用了路线的第三部分(ccc
上方),则将改为运行此方法。例如,account/return/insert
将加载/catalog/controller/account/return.php
文件和类,并尝试调用该insert
方法
OpenCart中的模型位于/catalog/model/
文件夹中,并且根据功能(而非路由)进行分组,因此您需要通过以下方式将其加载到控制器中
$this->load->model('xxx/yyy');
这会将文件加载到xxx
名为的子文件夹中yyy.php
。然后可以通过对象使用它
$this->model_xxx_yyy
与控制器一样,您只能调用其public
方法。例如,要调整图像大小,可以使用tool/image
模型并按resize
如下所示调用其方法
$this->load->model('tool/image');
$this->model_tool_image->resize('image.png', 300, 200);
为了将值从控制器传递到视图,您只需要将数据分配给$this->data
变量,该变量实际上是键=>值对的数组。举个例子
$this->data['example_var'] = 123;
如果您熟悉将每个键转换为变量的extract()方法,则在视图中访问它应该有点容易理解。所以example_var
密钥将变成$example_var
并且可以在视图中按原样访问。
主题仅在目录侧可用,并且基本上是模板,样式表和主题图像的文件夹。主题文件夹放置在/catalog/view/theme/
文件夹中,后跟主题名称。文件夹名称并不重要,但default
文件夹除外
管理员端使用/admin/view/template/
(跳过/theme/theme-name/
由于不允许不同的主题从路径中)
模板文件位于template
主题文件夹内的文件夹中。如果没有任何模板可用于当前选定的主题,则使用默认文件夹的模板作为后备。这意味着可以使用很少的文件来创建主题,并且仍然可以正常使用。它还可以减少代码重复和升级时的问题
与语言和模型一样,视图文件通常与路径相关,尽管不一定必须如此。/catalog/view/theme/your-theme/template/
除非不存在,否则通常会在目录侧找到模板,在这种情况下,将使用默认主题的模板。对于上面的搜索页面示例,文件为product/search.tpl
。对于三部分的路线,通常aaa/bbb_ccc.tpl
没有硬性规定。在管理员中,大多数页面都遵循此规则,除了页面列表项(例如产品列表页)位于页面中catalog/product_list.tpl
以及产品编辑表单位于其中catalog/product_form.tpl
。同样,这些没有设置,但是是默认购物车的标准。
模板文件实际上只是另一个php文件,但具有.tpl扩展名,并且实际上在控制器文件中运行,因此,您可以在控制器中进行编码的所有内容都可以在模板文件中运行(尽管除非绝对建议,否则不建议这样做)必要)
查询使用
$result = $this->db->query("SELECT * FROM `" . DB_PREFIX . "table`");
DB_PREFIX
顾名思义,是一个包含数据库前缀(如果存在)的常量
$result
将返回一个SELECT
查询对象,其中包含一些属性
$result->row
如果一个或多个作为关联数组返回,则包含第一行的数据
$result->rows
包含行结果数组,非常适合使用foreach进行循环
$result->num_rows
包含返回的结果数
该$this->db
对象还有一些其他方法
$this->db->escape()
在传递的值上使用mysql_real_escape_string()
$this->db->countAffected
返回受的影响的行数 UPDATE
查询依此类推
$this->db->getLastId()
使用mysql_insert_id()返回最后一个自动增量ID
Opencart的已预定义变量使用代替标准的$_GET
,$_POST
,$_SESSION
,$_COOKIE
,$_FILES
,$_REQUEST
和$_SERVER
$_SESSION
使用$this->session->data
其中data是模拟数组的关联数组进行编辑$_SESSION
其他所有对象都可以使用进行访问$this->request
并已被“清除”以符合启用/禁用的魔术引号,因此
$_GET
变成 $this->request->get
$_POST
变成 $this->request->post
$_COOKIE
变成 $this->request->cookie
$_FILES
变成 $this->request->files
$_REQUEST
变成 $this->request->request
$_SERVER
变成 $this->request->server
尽管以上内容并非针对开发人员的防弹指南,但希望它将为入门者提供一个良好的起点。
全局库方法:基本的opencart库功能及其功能,大多数这些都可以从目录或admin文件夹(控制器,模型,视图)中的任何位置调用
CACHE
$this->cache->delete($key) - Deletes cache [product, category, country, zone, language, currency,
manufacturer]
CART
$this->cart->getProducts() Gets all products currently in the cart including options, discounted prices, etc.
$this->cart->add( $product_id, $qty = 1, $options = array()) - Allows you to add a product to the cart
$this->cart->remove( $key ) - Allows you to remove a product from the cart
$this->cart->clear() - Allows you to remove all products from the cart
$this->cart->getWeight() - Sum of the weight of all products in the cart that have require shipping set to Yes
$this->cart->getSubTotal() - returns the subtotal of all products added together before tax
$this->cart->getTotal() - returns the total of all products added together after tax
$this->cart->countProducts() - returns the count of all product in the cart
$this->cart->hasProducts() - returns true if there is at least one item in the cart
$this->cart->hasStock() - returns false if there is at least one item in the cart that is out of stock
$this->cart->hasShipping() - returns true if there is at least one item in the cart that requires shipping
$this->cart->hasDownload() - returns true if there is at least one item in the cart that has a download
associated
CONFIG
$this->config->get($key) - returns setting value by keyname based on application (catalog or admin)
$this->config->set($key, $value) - set the value to override the setting value. DOES NOT SAVE TO DATABASE
CURRENCY
$this->currency->set($currency) - set or override the currency code to be used in the session
$this->currency->format($number, $currency = '', $value = '', $format = TRUE) - format the currency
$this->currency->convert($value, $from, $to) - convert a value from one currency to another. Currencies must
exist
$this->currency->getId() - get the database entry id for the current currency (1, 2, 3, 4)
$this->currency->getCode() - get the 3-letter iso code for the current currency (USD, EUR, GBP, AUD, etc)
$this->currency->getValue($currency) - get the current exchange rate from the database for the specified
currency.
$this->currency->has(currency) - Check if a currency exists in the opencart currency list
CUSTOMER
$this->customer->login($email, $password) - Log a customer in
$this->customer->logout() - Log a customer out
$this->customer->isLogged() - check if customer is logged in
$this->customer->getId() - get the database entry id for the current customer (integer)
$this->customer->getFirstName() - get customer first name
$this->customer->getLastName() - get customer last name
$this->customer->getEmail() - get customer email
$this->customer->getTelephone() - get customer telephone number
$this->customer->getFax() - get customer fax number
$this->customer->getNewsletter() - get customer newsletter status
$this->customer->getCustomerGroupId() - get customer group id
$this->customer->getAddressId() - get customer default address id (maps to the address database field)
DATABASE
$this->db->query($sql) - Execute the specified sql statement. Returns row data and rowcount.
$this->db->escape($value) - Escape/clean data before entering it into database
$this->db->countAffected($sql) - Returns count of affected rows from most recent query execution
$this->db->getLastId($sql) - Returns last auto-increment id from more recent query execution 4
DOCUMENT (*Called from controller only before renderer)
$this->document->setTitle($title) - Set page title
$this->document->getTitle()- Get page title
$this->document->setDescription($description) - Set meta description
$this->document->getDescription()- Get meta description
$this->document->setKeywords()- Set meta keywords
$this->document->getKeywords()- Get meta keywords
$this->document->setBase($base) - Set page base
$this->document->getBase() - Get page base
$this->document->setCharset($charset) - Set page charset
$this->document->getCharset() - Get page charset
$this->document->setLanguage($language) - Set page language
$this->document->getLanguage()- Get page language
$this->document->setDirection($direction) - Set page direction (rtl/ltr)
$this->document->getDirection()- Get page direction (rtl/ltr)
$this->document->addLink( $href, $rel ) – Add dynamic <link> tag
$this->document->getLinks()- Get page link tags
$this->document->addStyle( $href, $rel = 'stylesheet', $media = 'screen' ) – Add dynamic style
$this->document->getStyles()- Get page styles
$this->document->addScript( $script ) - Add dynamic script
$this->document->getScripts()- Get page scripts
$this->document->addBreadcrumb($text, $href, $separator = ' > ') – Add breadcrumb
$this->document->getBreadcrumbs()- Get Breadcrumbs
ENCRYPT
$this->encryption->encrypt($value) - Encrypt data based on key in admin settings
$this->encryption->decrypt($value) - Decrypt data based on key in admin settings
IMAGE
$this->image->resize($width = 0, $height = 0)
JSON
$this->json->encode( $data )
$this->json->decode( $data , $assoc = FALSE)
LANGUAGE
$this->language->load($filename);
LENGTH
$this->length->convert($value, $from, $to) - convert a length to another. units must exist
$this->length->format($value, $unit, $decimal_point = '.', $thousand_point = ',') - format the length to use
unit
LOG
$this->log->write($message) - Writes to the system error log
REQUEST
$this->request->clean($data) - Cleans the data coming in to prevent XSS
$this->request->get['x'] - Same as $_GET['x']
$this->request->post['x'] - Same as $_POST['x']
RESPONSE
$this->response->addHeader($header) - additional php header tags can be defined here
$this->response->redirect($url) - redirects to the url specified
TAX
$this->tax->setZone($country_id, $zone_id) - Set the country and zone id for taxing (integer)
$this->tax->calculate($value, $tax_class_id, $calculate = TRUE) - Calculate all taxes to be added to the total
$this->tax->getRate($tax_class_id) - Get the rates of a tax class id
$this->tax->getDescription($tax_class_id) - Get the description of a tax class id
$this->tax->has($tax_class_id) - Check if a tax class id exists in opencart
SESSION
$this->session->data['x'] - Same as $_SESSION['x']
有一个OpenCart Wiki网站,其中包含面向初学者的文档。请按照下面提供的网址获取更多详细信息:
http://wiki.opencarthelp.com/doku.php?id=start
http://wiki.opencarthelp.com/doku.php?id=methods_reference
互联网档案链接
http://web.archive.org/web/20160305131349/http://wiki.opencarthelp.com/doku.php?id=start http://web.archive.org/web/20160305131349/http://wiki .opencarthelp.com / doku.php?id = methods_reference
例如,方法参考中包含以下详细信息:
仍然有一些页面正在建设中,但这将有所帮助。
[更新]
截至2018年1月,opencarhelp.com域已关闭。
尽管已经多次回答了这个话题,但我还是想根据我的经验提供另一种掌握OpenCart的方法。
通过使用少量文件从头开始创建自己的OpenCart框架,您可以了解所有内容的组合方式。我将为您模仿OpenCart的文件结构。
建立档案 index.php
<?php
// My simpleCart
Opencart使用注册表模式列出所有已加载类的实例。这是您的OpenCart应用程序的心脏。然后将注册表对象传递给每个类别,模型和库,以快速访问其他对象。
用路径创建文件 /system/engine/registry.php
<?php
// Registry class.
class Registry
{
private $data = array();
public function set($key, $value){
$this->data[$key] = $value;
}
public function get($key){
return (isset($this->data[$key])) ? $this->data[$key] : false;
}
}
在你的 index.php
<?php
// My simpleCart
//load dependency files
require_once('system/engine/registry.php');
//initialize registry
$registry = new Registry;
现在让我们添加一个输出,它将是将来的HTML。毕竟,整个想法是将文本字符串发送到浏览器。
建立档案 system/library/response.php
<?php
class Response {
private $output;
public function getOutput() {
return $this->output;
}
public function setOutput($output) {
$this->output = $output;
}
public function output() {
if ($this->output) {
echo $this->output;
}
}
}
在你的 index.php
<?php
// My simpleCart
//load dependency files
require_once('system/engine/registry.php');
require_once('system/library/response.php');
//initialize registry
$registry = new Registry;
//initialize response
$response = new Response;
//add response object to the registry
$registry->set('response', $response);
//lets set an output as a test
$registry->get('response')->setOutput('Hello World');
//send the output to the client
$registry->get('response')->output();
注意,我仅以示例添加Hello world。我们将进一步删除它。刷新您的网站进行检查。浏览器应显示
Hello World
。
将控制器视为页面。他们将定义将显示给客户端的内容:文本,html,json,下载或图像。现在,我们只需要一个发送文本的页面。
我们将为home
页面创建一个控制器。
添加带有路径的文件 catalog/controller/common/home.php
<?php
class ControllerCommonHome{
private $registry = array();
public function __construct($registry){
$this->registry = $registry;
}
public function index(){
$output = 'Home Page';
//using the registry to get the response object and set the Output
$this->registry->get('response')->setOutput($output);
}
}
并编辑您的 index.php
<?php
// My simpleCart
//load registry
require_once('system/engine/registry.php');
//load response
require_once('system/library/response.php');
//initialize registry
$registry = new Registry;
//initialize response
$response = new Response;
//add resoinse object to the registry
$registry->set('response', $response);
//load controller common/home
require_once('catalog/controller/common/home.php');
$controller = new ControllerCommonHome($registry);
$controller->index();
//send the output to the client
$registry->get('response')->output();
注意如何将传递
$refistry
给ControllerCommonHome,以便可以在控制器内部访问它。
我们不希望对控制器进行硬编码,对。我们将使用route
网址中的参数来告诉购物车加载哪个控制器。
使用路径创建文件 system/library/request.php
<?php
class Request {
public $get = array();
//for now I just need the $_GET parameter
public function __construct() {
$this->get = $_GET;
}
}
创建负责基于路由初始化Controller文件的Router类(换句话说:动态调用控制器)
<?php
class Router {
private $registry;
public function __construct($registry) {
$this->registry = $registry;
}
public function dispatch($route) {
require_once('catalog/controller/'.$route.'.php');
$class = "Controller".str_replace('/', '', $route);
$controller = new $class($this->registry);
$controller->index();
}
}
加载到您的 index.php
<?php
require_once('system/engine/registry.php');
require_once('system/engine/router.php');
require_once('system/library/response.php');
require_once('system/library/request.php');
$registry = new Registry;
$response = new Response;
$registry->set('response', $response);
$request = new Request;
$registry->set('request', $request);
//get the route from the url
if(isset($registry->get('request')->get['route'])){
$route = $registry->get('request')->get['route'];
}else{
$route = 'common/home';
}
//initiate the router and dispatch it base on the route
$router = new Router($registry);
$router->dispatch($route);
$registry->get('response')->output();
请注意,我是如何将所有内容加载到中
$registry
,然后将其传递到的$router
,然后再将其传递到的$controller
。
这篇文章已经太长了,但是我希望它能对OpenCart中的MVC模式有一个基本的了解。
如果您希望我继续这篇文章,并告诉您其他事物(例如模型和视图)是如何工作的,请对该答案进行评分,以便我知道。
还要查看我的Youtube https://www.youtube.com/dreamvention和我的博客https://dreamvention.com/blog,我将在那里为您发布更多的提示和教程!
PHP是一种相当大的语言,具有5000多个内置函数,因此学习新平台的一种策略是确定它最常使用哪些功能,并花一些时间来很好地了解这些功能。
我已经在OpenCart源代码上运行了一些查询,最常用的10个函数是:
array()
count()
explode()
implode()
mktime()
delete()
time()
date()
sprintf()
list()
此处列出的所有52条代码以及您可以在任何代码库上用来识别常用功能的Linux bash命令:https : //www.antropy.co.uk/blog/efficiency-learning-for-new-opencart-developers/
这个youtube视频播放列表也可能有助于成为OpenCart开发人员Gurus:
OpenCart中的MVCL模式,代码流以及请求和响应它显示了OpenCart中的MVCL模式,代码流以及请求和响应。它们描述流程如下图所示:
安装,配置和卸载Opencart模块它显示了三种上传模块,然后安装,配置和卸载OpenCart 3模块/扩展的方法。
Opencart 3中的布局和位置它描述了OpenCart 3的布局和位置。它显示了如何显示不同页面的自定义布局,并给出了类别页面的示例。我们显示了不同类别的不同布局。
Opencart的事件概述您将了解OpenCart中的事件,事件如何工作以及使事件如此有用的原因。
针对开发人员的Opencart API文档该视频将演示如何使用和制作自定义opencart API
看到这些视频后,您就可以开始编码了:)