PHP scripts for CADViewer control of back-end converters.
1: PHP scripts for CADViewer for communication between CADViewer and server side AutoXchange 2024 CAD converter, as well scrips for all other server operations; file-operations, etc.
- Install this in its preferred folder structure: /cadviewer/php/
- With CADViewer Script Library on Windows, the folder: C:\xampp\htdocs\cadviewer\php
- With CADViewer Script Library on Linux, the folder: /var/www/html/cadviewer/php
2: CADViewer Script Library, see: https://github.com/CADViewer/cadviewer-script-library
3: Any back-end CAD Converters such as AutoXchange 2024
Install CADViewer and back-end CAD Converters, follow installation instructions from the documentation link below.
A: As a preferred alternative, install a full server of CADViewer including both script library and converters in a preferred folder-structure. https://github.com/CADViewer/cadviewer-script-library
B: Configuration file setup
- If on Windows, copy CADViewer_config_windows.php to *CADViewer_config.php (setup for /xampp/htdocs/cadviewer)
- If on Linux, copy CADViewer_config_linux.php to *CADViewer_config.php (setup for /var/www/html/cadviewer)
C: Once 2: and 3: is installed, typically the HTML samples are under /cadviewer/html/ and can be run from a web-browser. Use http://localhost/cadviewer/html/CADViewer_fileloader_80.html as a starting point (assuming that your have installed under http://localhost).
D: If changing the location of the installation, please update /cadviewer/php/CADViewer_config.php. The top part of this config file contains automated settings of $home_dir (cadviewer install folder) and $httpHost (cadviewer install folder url), but they can be manually overwritten. It also contains settings for the install platform (windows or linux).
E: If updating any of executables in the install structure, then update their variable names in */cadviewer/php/CADViewer_config.php. These varaiables can be found with "_executable" in the variable name, for example "ax2023_executable".
F: Please note the variable controls in the HTML documents as described below in Troubleshooting.
Please refer to the general Documentation above, for the PHP back-end handlers, there is more information on:
1: If a drawing does not display, or an conversion error is indicated, open the log file: cadviewer/php/call-Api_Conversion_log.txt . This file list all activity concerning the conversion. Typical error is incorrect path settings.
In the log file, locate before call to exec: , capture this command line, strip off the "" around the executable (first part), then open a command prompt and execute this command line from the command prompt. If there are issues with permissions, path naming, executable naming, etc., this command line will show.
2: When installing the user of the cadviewer install folder may be different from the user when calling cadviewer. So whereas it's installed as userX or root, the actual user can be apache or www-root, please use: chown -R www-root:www-root /var/www/html/cadviewer/ to change accordingly.
3: One issue that often appears in installations is that interface icons do not display properly:
Typically the variables ServerUrl, ServerLocation or ServerBackEndUrl in the controlling HTML document in /cadviewer/html/ are not set to reflect the front-end server url or port.
var ServerBackEndUrl = ""; // or what is appropriate for my server; used for NodeJS server only
var ServerUrl = "http://localhost/cadviewer/"; // or what is appropriate for my server
var ServerLocation = ""; // or what is appropriate for my server
4: Another issue can be that the path settings in /cadviewer/php/CADViewer_config.php are not done correctly. This typically manifests in that the drawing will not load/display correctly in CADViewer.
Open the debug file: /cadviewer/php/call-Api_Conversion_log.txt
A. check that all paths and executable names correspond to server settings, if not modify /cadviewer/php/CADViewer_config.php.
B: identify the command line string for the conversion, it will be directly after the string "before call to exec:"
"C:\xampp\htdocs\cadviewer\/converters/ax2022/windows//AX2022_W64_22_11_59.exe" "-i=C:\xampp\htdocs\cadviewer\/content/drawings/dwg/hq17_.dwg" "-o=C:\xampp\htdocs\cadviewer\/converters/files/f2134145163.svg" "-f=svg" -last "-rl=RM_" "-tl=RM_TXT" "-lpath=C:\xampp\htdocs\cadviewer\/converters/ax2022/windows/"
Run this from a command line prompt. Checks if there are any permission or path issues. Change in /cadviewer/php/CADViewer_config.php or file-name in the calling HTML document.
Have Fun! - and get in touch with us!