{"id":2547,"date":"2022-07-08T19:48:53","date_gmt":"2022-07-08T17:48:53","guid":{"rendered":"https:\/\/fhumanes.es\/blog\/?page_id=2547"},"modified":"2022-07-11T20:57:07","modified_gmt":"2022-07-11T18:57:07","slug":"guia-40-instalar-desarrollo-phprunner-en-multiples-instancias-con-personalizacion","status":"publish","type":"page","link":"https:\/\/fhumanes.es\/blog\/guias-desarrollo\/guia-40-instalar-desarrollo-phprunner-en-multiples-instancias-con-personalizacion\/","title":{"rendered":"Gu\u00eda 40 &#8211; Instalar desarrollo PHPRunner en m\u00faltiples instancias con personalizaci\u00f3n"},"content":{"rendered":"<p><img loading=\"lazy\" decoding=\"async\" class=\"alignleft wp-image-1284\" src=\"https:\/\/fhumanes.es\/blog\/wp-content\/uploads\/2020\/07\/guia1_008.png\" alt=\"\" width=\"150\" height=\"150\" srcset=\"https:\/\/fhumanes.es\/blog\/wp-content\/uploads\/2020\/07\/guia1_008.png 200w, https:\/\/fhumanes.es\/blog\/wp-content\/uploads\/2020\/07\/guia1_008-150x150.png 150w\" sizes=\"auto, (max-width: 150px) 100vw, 150px\" \/>Muchas de las consultas\u00a0 que he tenido era a consecuencia de c\u00f3mo desarrollar un aplicativo en PHPRunner e instalar el mismo para varias Oficinas o Empresas.<br \/>\nAnte estas situaciones, normalmente te preguntas:<\/p>\n<ul>\n<li>\u00bfSe utiliza una \u00fanica instancia de base de datos para todas las empresas?<\/li>\n<li>\u00bfC\u00f3mo se personaliza la aplicaci\u00f3n para que disponga de identificaci\u00f3n (logo, nombre de la compa\u00f1\u00eda, etc.) para cada empresa?.<\/li>\n<\/ul>\n<p>Hay muchas m\u00e1s preguntas, pero estas suelen ser las \u00abgrandes\u00bb y dif\u00edciles de contestar.<\/p>\n<p>Normalmente indico que <strong>si son datos de una \u00fanica empresa<\/strong>, pero el an\u00e1lisis de los mismos es por departamento, almac\u00e9n o cosa similar, se utilice una \u00fanica base de datos y en todas las tablas se indique el departamento, almac\u00e9n, etc., para gestionar autorizaciones de acuerdo a esa divisi\u00f3n de la informaci\u00f3n.<br \/>\nTengo un ejemplo que utiliza este sistema,\u00a0 es la <a href=\"https:\/\/fhumanes.es\/blog\/workflow\/workflow-version-3-0\/\" target=\"_blank\" rel=\"noopener\">aplicaci\u00f3n de M\u00faltiples Workflows<\/a>, donde la clave de selecci\u00f3n es el \u00ab<strong>Id<\/strong>\u00bb del proceso de gesti\u00f3n.<\/p>\n<p>Ahora bien, si la misma aplicaci\u00f3n <strong>es para empresas no relacionadas<\/strong> y nunca se va a analizar la informaci\u00f3n uniendo los datos de estas, lo m\u00e1s interesante es que sean distintas instancias de base de datos y tambi\u00e9n de aplicaciones (de cara a la personalizaci\u00f3n de cada empresa). Y en este caso, <strong>\u00bf C\u00f3mo gestionamos el proyecto en PHPRunner?<\/strong><\/p>\n<ul>\n<li>\u00bfTenemos versiones del proyecto <strong>distintos<\/strong> para cada una de las instancias?<br \/>\nEsto significa que la evoluci\u00f3n del producto va a ser diferente y por lo tanto las gestiones de cambios y evoluci\u00f3n va a ser mucho m\u00e1s complejas.<\/li>\n<li>\u00bfTenemos una <strong>\u00fanica versi\u00f3n del proyecto<\/strong> para todas las instancias\/empresas?<br \/>\nEsto significa generar versiones diferenciadas de aplicaci\u00f3n con personalizaciones de cada una de las instancias\/empresas. \u00bfC\u00f3mo se podr\u00eda gestionar esto?<\/li>\n<\/ul>\n<h4>Objetivo<\/h4>\n<p>Dise\u00f1ar una alternativa para disponer de <strong>un \u00fanico proyecto de PHPRunner<\/strong> e instalar el mismo para varias empresas, personalizando la instancia de acuerdo a las caracter\u00edsticas de la empresa a la que va a ofrecer servicio.<\/p>\n<h4>Soluci\u00f3n T\u00e9cnica<\/h4>\n<p>Realmente, no estoy inventando nada, lo que se desea obtener es lo que se suele estar disponible para cualquier desarrollo de PHP, es decir, que el aplicativo se personalice mediante un fichero de configuraci\u00f3n.<\/p>\n<p>En dicho fichero, adem\u00e1s de los datos de conexi\u00f3n a la base de datos, tambi\u00e9n tiene que disponer de personalizaci\u00f3n de las caracter\u00edsticas que son diferentes entre las compa\u00f1\u00edas que utilizan el aplicativo.<\/p>\n<p>Para dar respuesta a estos requisitos en la soluci\u00f3n de PHPRunner, he definido:<\/p>\n<ol>\n<li>\u00a0Crear un fichero \u00ab<strong>config.php<\/strong>\u00bb para establecer\u00a0 los datos de conexi\u00f3n a la base de datos.<\/li>\n<li>En el mismo fichero \u00ab<strong>config.php<\/strong>\u00ab, establecer en variables de sesi\u00f3n los valores de personalizaci\u00f3n (diferencias) de los valores que hay entre las empresas.<\/li>\n<li>Aislar las identificaciones de los usuarios de las distintas instancias (necesario por usar la misma cookie de sesi\u00f3n para todas las instancias de la aplicaci\u00f3n)<\/li>\n<li>Por arquitectura de PHPRunner, hay personalizaciones que est\u00e1n s\u00f3lo en HTML (por ejemplo, logo de la aplicaci\u00f3n), deseamos cambiarlo sin tener que generar varias veces el producto. Para ello se utilizar un JavaScript \u00ab<a href=\"https:\/\/github.com\/LexmarkWeb\/csi.js\" target=\"_blank\" rel=\"noopener\"><strong>csi.js<\/strong><\/a>\u00bb , que nos va a permitir personalizar este tipo de informaci\u00f3n sin tener que generar desde PHPRunner.<\/li>\n<\/ol>\n<p>Como visualmente no tiene pr\u00e1cticamente diferencias, no os facilito URL de pruebas, no obstante en el Kit que os dejo para instalar en vuestros PC, os dejo 2 bases de datos \u00abbusiness_1\u00bb y \u00abbusiness_2\u00bb, para que confirm\u00e9is que pod\u00e9is hacer la personalizaci\u00f3n de la 2\u00aa instancia sin volver a generar desde PHPRunner.<\/p>\n<h4>Codificaci\u00f3n realizada<\/h4>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter wp-image-2551 size-full\" src=\"https:\/\/fhumanes.es\/blog\/wp-content\/uploads\/2022\/07\/business_001.png\" alt=\"\" width=\"733\" height=\"589\" srcset=\"https:\/\/fhumanes.es\/blog\/wp-content\/uploads\/2022\/07\/business_001.png 733w, https:\/\/fhumanes.es\/blog\/wp-content\/uploads\/2022\/07\/business_001-300x241.png 300w\" sizes=\"auto, (max-width: 733px) 100vw, 733px\" \/><\/p>\n<p>En el directorio \u00ab<strong>MyCode<\/strong>\u00bb va a estar todos los ficheros de personalizaci\u00f3n que podremos modificar externamente a la herramienta de PHPRunner.<\/p>\n<p><a href=\"https:\/\/fhumanes.es\/blog\/wp-content\/uploads\/2022\/07\/business_002.png\"><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter wp-image-2550\" src=\"https:\/\/fhumanes.es\/blog\/wp-content\/uploads\/2022\/07\/business_002-300x105.png\" alt=\"\" width=\"800\" height=\"280\" srcset=\"https:\/\/fhumanes.es\/blog\/wp-content\/uploads\/2022\/07\/business_002-300x105.png 300w, https:\/\/fhumanes.es\/blog\/wp-content\/uploads\/2022\/07\/business_002-1024x359.png 1024w, https:\/\/fhumanes.es\/blog\/wp-content\/uploads\/2022\/07\/business_002-768x269.png 768w, https:\/\/fhumanes.es\/blog\/wp-content\/uploads\/2022\/07\/business_002.png 1173w\" sizes=\"auto, (max-width: 800px) 100vw, 800px\" \/><\/a>Para que la funcionalidad del JavaScript \u00ab<strong>csi.js<\/strong>\u00bb est\u00e9 disponible en todas las p\u00e1ginas he modificado la plantilla de la cabecera de todas las p\u00e1ginas para cargar este JavaScript.<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter wp-image-2552 size-full\" src=\"https:\/\/fhumanes.es\/blog\/wp-content\/uploads\/2022\/07\/business_004.png\" alt=\"\" width=\"756\" height=\"589\" srcset=\"https:\/\/fhumanes.es\/blog\/wp-content\/uploads\/2022\/07\/business_004.png 756w, https:\/\/fhumanes.es\/blog\/wp-content\/uploads\/2022\/07\/business_004-300x234.png 300w\" sizes=\"auto, (max-width: 756px) 100vw, 756px\" \/><\/p>\n<p>En la definici\u00f3n del Logo, que PHPRunner s\u00f3lo admite la introducci\u00f3n de HTML incluimos entre &lt;<strong>span&gt;<\/strong> o <strong>&lt;div&gt;<\/strong> el atributo \u00ab<strong>data-include<\/strong>\u00bb con la carga del fichero o la ejecuci\u00f3n de un fichero en el server que va a sustituir esta parte de HTML. Esto se ha hecho para personalizar el icono del logo y el nombre de la empresa.<\/p>\n<p><a href=\"https:\/\/fhumanes.es\/blog\/wp-content\/uploads\/2022\/07\/business_003.png\"><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter wp-image-2553\" src=\"https:\/\/fhumanes.es\/blog\/wp-content\/uploads\/2022\/07\/business_003-300x154.png\" alt=\"\" width=\"800\" height=\"411\" srcset=\"https:\/\/fhumanes.es\/blog\/wp-content\/uploads\/2022\/07\/business_003-300x154.png 300w, https:\/\/fhumanes.es\/blog\/wp-content\/uploads\/2022\/07\/business_003-1024x526.png 1024w, https:\/\/fhumanes.es\/blog\/wp-content\/uploads\/2022\/07\/business_003-768x395.png 768w, https:\/\/fhumanes.es\/blog\/wp-content\/uploads\/2022\/07\/business_003.png 1121w\" sizes=\"auto, (max-width: 800px) 100vw, 800px\" \/><\/a>Aqu\u00ed pod\u00e9is apreciar el resultado de la ejecuci\u00f3n del fichero \u00ab<strong>logo.php<\/strong>\u00bb<\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"generic\">&lt;?php\r\n\/\/ Build HTML of the company logo || Construye HTML del Logo de la Emmpresa\r\nrequire_once(__DIR__. \"\/..\/include\/dbcommon.php\");\r\n$title = $_SESSION[\"app-title\"]  ;\r\necho '&lt;span style=\"background-color:white; color:black;font-size: 20px;\"&gt;&lt;img src=\"MyCode\/logo.png\" alt=\"'.$title.'\" width=\"20\"&gt; '.$title.'&lt;\/span&gt;';\r\n?&gt;<\/pre>\n<p>Podr\u00edamos hacer todo tipo de c\u00e1lculos con accesos o no a la informaci\u00f3n de la base de datos.<\/p>\n<p>El fichero \u00ab<strong>config.php<\/strong>\u00bb tiene estos datos:<\/p>\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"generic\">&lt;?php \r\n\/\/ Database connection || Conexi\u00f3n a la base de datos\r\n$host=\"localhost\";\r\n$user=\"root\";\r\n$pwd=\"password\";\r\n$port=\"\";\r\n$sys_dbname=\"business_1\";  \/\/ Database\r\n\r\n\/\/ Identification of the company || Identificaci\u00f3n de la Empresa \r\n$business = 'business_1';\r\n\r\n\/\/ Company customization variables || Variables de personalizaci\u00f3n de la Empresa\r\n$_SESSION[\"app-title\"] = \"Business 1\";  \/\/ Mandatory that they are session variables || Obligatorio que sean variables de sesi\u00f3n \r\n\/\/ All the variables that are required || Todas las variables que se requieram\r\n\r\n\/\/ Control para verificar que se ha identificado en esta aplicaci\u00f3n. Requerido por compartir identificaci\u00f3n cookie de de sessi\u00f3n\r\n\/\/ Control to verify that it has been identified in this application. Required for sharing cookie of session\r\nif (isset($_SESSION['business'])) {\r\n    if ($_SESSION['business'] &lt;&gt; $business ){\r\n        $_SESSION['business'] = $business;\r\n        \/\/**********  Redirect to another page  ************\r\n        header(\"Location: login.php?a=logout\"); \/\/ User session is closed if not entry into this || Se cierra sesi\u00f3n de usuario si no se ha entrada en esta\r\n        exit();\r\n    }\r\n} else {\r\n    $_SESSION['business'] = $business; \r\n}\r\n<\/pre>\n<p>Como el ejemplo es muy simple (s\u00f3lo tiene por objeto explicar una de las formas de personalizar el aplicativo de forma externa) tiene muy poquitas definiciones, pero podr\u00edamos utilizar este m\u00e9todo para personalizaciones de c\u00f3digo muy importantes.<\/p>\n<p>Est\u00e1 dividido en varias partes:<\/p>\n<ol>\n<li>Las variables de configuraci\u00f3n de la conexi\u00f3n a la base de datos.<\/li>\n<li>Identificaci\u00f3n de la Compa\u00f1\u00eda o instancia. Muy importante para asegurarnos los accesos correctos, ya que el aplicativo mantiene la misma Cookie de sesi\u00f3n para todas las instancias y si estas en comparten el mismo dominio (URL), podr\u00edan los usuarios pasar de una aplicaci\u00f3n a otra, con al credencial de la primera aplicaci\u00f3n. Este valor debe ser \u00fanico en cada aplicaci\u00f3n\/instancia.<\/li>\n<li>Conjunto de variables de sesi\u00f3n que van a disponer de la personalizaci\u00f3n de esta instancia de aplicaci\u00f3n.<\/li>\n<li>C\u00f3digo o l\u00f3gica, que nos va a verificar que se ha hecho login en esta aplicaci\u00f3n\/instancia.<\/li>\n<\/ol>\n<p>Para que se utilice este fichero de configuraci\u00f3n tenemos que hacer esta definici\u00f3n.<a href=\"https:\/\/fhumanes.es\/blog\/wp-content\/uploads\/2022\/07\/business_005.png\"><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter wp-image-2554\" src=\"https:\/\/fhumanes.es\/blog\/wp-content\/uploads\/2022\/07\/business_005-282x300.png\" alt=\"\" width=\"800\" height=\"850\" srcset=\"https:\/\/fhumanes.es\/blog\/wp-content\/uploads\/2022\/07\/business_005-282x300.png 282w, https:\/\/fhumanes.es\/blog\/wp-content\/uploads\/2022\/07\/business_005-768x816.png 768w, https:\/\/fhumanes.es\/blog\/wp-content\/uploads\/2022\/07\/business_005.png 952w\" sizes=\"auto, (max-width: 800px) 100vw, 800px\" \/><\/a> Como pod\u00e9is apreciar, PHPRunner tiene la funcionalidad de poder describir varias conexiones a base de datos y generar el c\u00f3digo con esa personalizaci\u00f3n. En este caso, vamos a utilizar esta funcionalidad, pero en vez de indicar los valores de la conexi\u00f3n le indicamos que ejecute el fichero \u00ab<strong>config.php<\/strong>\u00ab.<\/p>\n<p>Espero que os guste. Seguramente hay otras formas de hacer esto mismo, pero esta me ha parecido simple y clara, para que se entienda por todos los desarrolladores.<\/p>\n<p>Os dejo el ejemplo, con 2 bases de datos, para que puedas hace generar \u00abt\u00fa\u00bb versi\u00f3n y duplicarla. Aunque est\u00e1 en versi\u00f3n PHPRunner 10.7, esto mismo funcionar\u00eda en cualquier versi\u00f3n 10.X<\/p>\n<p>Para cualquier duda o necesidad, poneros en contacto contigo a trav\u00e9s de mi email <a href=\"mailto:fernandohumanes@gmail.con\">fernandohumanes@gmail.con<\/a><\/p>\n<p>&nbsp;<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Muchas de las consultas\u00a0 que he tenido era a consecuencia de c\u00f3mo desarrollar un aplicativo en PHPRunner e instalar el mismo para varias Oficinas o Empresas. Ante estas situaciones, normalmente te preguntas: \u00bfSe utiliza una \u00fanica instancia de base de datos para todas las empresas? \u00bfC\u00f3mo se personaliza la aplicaci\u00f3n para que disponga de identificaci\u00f3n &hellip; <a href=\"https:\/\/fhumanes.es\/blog\/guias-desarrollo\/guia-40-instalar-desarrollo-phprunner-en-multiples-instancias-con-personalizacion\/\" class=\"more-link\">Seguir leyendo <span class=\"screen-reader-text\">Gu\u00eda 40 &#8211; Instalar desarrollo PHPRunner en m\u00faltiples instancias con personalizaci\u00f3n<\/span> <span class=\"meta-nav\">&rarr;<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"parent":1254,"menu_order":84,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-2547","page","type-page","status-publish","hentry"],"_links":{"self":[{"href":"https:\/\/fhumanes.es\/blog\/wp-json\/wp\/v2\/pages\/2547","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/fhumanes.es\/blog\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/fhumanes.es\/blog\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/fhumanes.es\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/fhumanes.es\/blog\/wp-json\/wp\/v2\/comments?post=2547"}],"version-history":[{"count":8,"href":"https:\/\/fhumanes.es\/blog\/wp-json\/wp\/v2\/pages\/2547\/revisions"}],"predecessor-version":[{"id":2563,"href":"https:\/\/fhumanes.es\/blog\/wp-json\/wp\/v2\/pages\/2547\/revisions\/2563"}],"up":[{"embeddable":true,"href":"https:\/\/fhumanes.es\/blog\/wp-json\/wp\/v2\/pages\/1254"}],"wp:attachment":[{"href":"https:\/\/fhumanes.es\/blog\/wp-json\/wp\/v2\/media?parent=2547"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}